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About This Manual 


This manual provides information needed to set up OEM platforms running 
the Compaq Tru64™ UNIX operating system. It helps system and network 
administrators configure PCI/ISA modular single-board computers (SBCs), 
Alpha VME SBCs, and VMEbus backplane (vb) networks in which SBCs 
operate as Ethernet nodes. 


Audience 


This manual is for experienced system and network administrators who are 
thoroughly familiar with their platform's 1/O bus and with the operating 
system concepts, commands, and configurations. 


Organization 
This manual contains the following chapters. 


Chapter 1 OEM Platform Requirements and Restrictions 


Provides notes about the use of OEM platforms, with a section 
devoted to each platform family. 


Chapter 2 Configuring the VMEbus for Alpha VME Systems 


Explains how to configure VMEbus adapters for OEM platforms, 
with a section devoted to each major adapter type. 


Chapter 3 Configuring a VMEbus Backplane (vb) Network 


Explains how to set up a VME bus backplane-based network in which 
Alpha VME single-board computers (SBCs) operate as Ethernet 
nodes. 


Related Documents 


The following documents are relevant to setting up OEM platforms: 

¢« Systen Configuration and Tuning 

¢ Systen Administration 

¢ Network Administration 

¢ Your platform's hardware documentation 

e Thesys attrs_ vba _vipvic(7) kernel subsystem reference page 
« Thesys attrs vba_univ(7) kernel subsystem reference page 
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« Thesys attrs vme_vba(7) kernel subsystem reference page 
¢ Thesys attrs(5) reference page 

« Thesysconfigdb(8) reference page 

« Release Notes Processor-Specific Notes 

¢ Installation Guide platform-specific instructions for booting 

¢ Guideto Realtime Programming 

¢« Device Driver Kit manual Writing VMEbus Device Drivers 

¢ Device Driver Kit manual Writing PCI Bus DeviceDrivers 


Icons on Tru64 UNIX Printed Books 


The printed version of the Tru64 UNIX documentation uses letter icons on 
the spines of the books to help specific audiences quickly find the books that 
meet their needs. (You can order the printed documentation from Compaq.) 
The following list describes this convention: 

Books for general users 

Books for system and network administrators 

Books for programmers 


Books for device driver writers 


DUD NN QA 


Books for reference page users 


Some books in the documentation help meet the needs of several audiences. 
For example, the information in some system books is also used by 
programmers. Keep this in mind when searching for information on specific 
topics. 


The Documentation Overview provides information on all of the books in 
the Tru64 UNIX documentation set. 
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Reader’s Comments 


Compaq welcomes any comments and suggestions you have on this and 
other Tru64 UNIX manuals. 


You can send your comments in the following ways: 


Fax: 603-884-0120 Attn: UBPG Publications, ZK 03-3/Y 32 
Internet electronic mail: readers _comment@zk3.dec.com 


A Reader’s Comment form is located on your system in the following 
location: 


/usr/doc/readers_comment.txt 
Mail: 


Compaq Computer Corporation 
UBPG Publications Manager 
ZK O3-3/Y 32 

110 Spit Brook Road 

Nashua, NH 03062-2698 


A Reader’s Comment form is located in the back of each printed manual. 
The form is postage paid if you mail it in the United States. 


Please include the following information along with your comments: 


The full title of the book and the order number. (The order number is 
printed on the title page of this book and on its back cover.) 


The section numbers and page numbers of the information on which 
you are commenting. 


The version of Tru64 UNIX that you are using. 
If known, the type of processor that is running the Tru64 UNIX software. 


The Tru64 UNIX Publications group cannot respond to system problems 

or technical support inquiries. Please address technical questions to your 
local system vendor or to the appropriate Compaq technical support office. 
Information provided with the software media explains how to send problem 
reports to Compaq. 


About This Manual xi 


Conventions 


xii 


This manual uses the following conventions: 


cat(1) 
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A percent sign represents the C shell system prompt. 
A number sign represents the default superuser prompt. 


Three right angle brackets represent the console 
subsystem prompt. 


Boldface type in interactive examples indicates typed user input. 


Italic (slanted) type indicates variable values, placeholders, 
and routine argument names. 


A vertical ellipsis indicates that a portion of an example 
that would normally be present is not shown. 


A cross-reference to a reference page includes the appropriate 
section number in parentheses. For example, cat(1) 
indicates that you can find information on the cat command 
in Section 1 of the reference pages. 


1 


OEM Platform Requirements and 
Restrictions 


This chapter provides notes about the use of OEM platforms, with a section 
devoted to each platform family: 


¢ PCI/ISA modular single-board computers [SMARTengine/Alpha and 
EBMnn] (Section 1.1) 


e Alpha VME 4/nnn and 5/nnn single-board computers [EBVnn] 
(Section 1.2) 


« AXPvmesingle-board computers (Section 1.3) 


1.1 PCI/ISA Modular Single-Board Computers 
(SMARTengine/Alpha and EBMnn) 


The SMARTengine/Alpha 21264 single-board computer (SBC) and its 
predecessors, the EBM2n and EBM4n SBCs, are members of a family of 
PCI/ISA-based modular computing components. (The PCI/ISA systems 
and components product family was formerly known as DIGITAL Modular 
Computing Components, or DMCC). 


The SMARTengine/Alpha 21264 PCI/ISA SBC is a PLCMG-compliant 
processor card based on the Compag Alpha 21264 CPU. The EBM 2n and 
EBM4n SBCs are PICMG-compliant processor cards based on the Compaq 
Alpha 21164 and 21064A CPUs, respectively. 


The following notes are specific to PCI/ISA modular SBCs. 


1.1.1 Verifying CPU Version 


You can use the sizer utility to identify SMARTengine/Alpha 21264, 
EBM2n, and EBM4n SBCs. Thesizer -c command displays the following 
output for SMARTengine/Alpha 21264 SBCs: 


sysname> sizer -c 
cpu "DMCCEV6" 


Thesizer -c command displays the following output for EBM 2n SBCs: 


sysname> sizer -c 
cpu "DECEV56_PBP" 
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Thesizer -c command displays the following output for EBM 4n SBCs: 


sysname> sizer -c 
cpu "DECEV45_ PBP" 


1.1.2 Firmware Requirements 


Before installing the operating system, make sure that your system has 
the correct firmware version. The minimum firmware version required 
for SMARTengine/Alpha 21264 SBCs is Version 5.6-6903 or higher. The 
minimum firmware version required for EBM2n and EBM4n SBCs is 
Version 4.7 or higher. If you have an earlier firmware version, update your 
firmware before installing the operating system software. F or information 
on how to update your firmware, see the firmware documentation. 


To determine the version of firmware on your system, enter the following 
console firmware command at the prompt: 


>>> show version 


1.1.3 Installing Tru64 UNIX 


For information about installing the operating system on a 
SMARTengine/Alpha 21264, EMB2n, or EBM4n SBC, see the Tru64 UNIX 
Installation Guide. The Installation Guide provides platform-specific 
instructions for booting. F or the SMARTengine/Alpha 21264 SBC, follow the 
same instructions as for the EBM2n and EBM 4n SBCs. 


1.1.4 Restrictions and Known Problems 


The following restrictions and known problems apply to PCI/ISA modular 
SBCs. 


1.1.4.1. Option Card Restrictions 


You can use the SMARTengine/Alpha 21264, EBM2n, and EBM4n SBCs on 
PCI/ISA backplanes in the ETMXB/ETMAB family and in corresponding 
kernels (platforms) in the ETMnn family. Table 1-1 lists the currently 
supported PCI/ISA backplanes and kernels. Not every SBC is supported in 
every backplane and kernel; see the current PCI/ISA components order 
configuration guide for details. 
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Table 1-1: Supported PCI/ISA Backplanes and Kernels 


Backplane Kernel Description 

ETMXB-BA ETM05-xx 5-slot PICMG (2 PCI, 1 PCI/ISA, 11SA, 1 SBC) 

ETMXB-DA ETM27-SA, 7-slot PLCMG (3 PCI, 1 PCI/ISA, 11SA, 2 
3X-ETM17-xx SBC [1 SBC slot usable at a time]) 

ETMAB-CA ETM 25-xx, 10-slot PICMG (6 PCI, 1 PCI/ISA, 11SA, 2 
3X-ETM 15-xx SBC [1 SBC slot usable at a time]) 

ETMAB-EA ETM 29-xx, 10-slot PICMG (4 PCI/ISA, 41SA, 2 SBC 
3X-ETM 19-xx [1 SBC slot usable at a time]) 

ETMAB-AB ETM31-CA 14-slot PICMG (7 PCI, 61SA, 1 SBC) 

ETMAB-BB ETM 33-CA 14-slot PICMG (10 PCI, 31SA, 1 SBC) 

ETMAB-AC ETM 42-CA 19-slot PICMG (10 PCI, 7 ISA, 2 SBC [1 

SBC slot usable at a time]) 
ETMAB-BC ETM 44-CA 19-slot PICMG (13 PCI, 4ISA, 2 SBC [1 


SBC slot usable at a time]) 


All ETMAB backplanes use PCI-to-PCI bridge (PPB) technology 
to provide both primary (in front of the bridge) and secondary 
(behind the PPB) slots. All ETMAB backplanes are compliant 
with PCI Version 2.1. 


The option cards shown in Table 1-2, in addition to working in front of the 
bridge, work behind the bridge. You can plug these cards into any available 


slot. 


Table 1-2: PCI/ISA Options Supported Behind the Bridge 


Option Type Part Number Description 

Graphics SN-PBXGB-AA TGA2 2MB PowerStorm 3D30 

Graphics SN-PBXGK-BB Elsa GLoria Synergy 

SCSI KZPBA-CB Qlogic PCI Ultra Wide differential 
SCSI controller 

SCSI KZPCM-DA Dual-channel PCI to Ultra SCSI 
adapter with Ethernet controller 

SCSI KZPSA-BB PCI differential SCSI adapter 

SCSI SN-KZPBA-CA Qlogic PCI-SCSI Ultra Wide 


adapter (supports both narrow 
and wide drives) 
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Table 1-2: PCI/ISA Options Supported Behind the Bridge (cont.) 


Option Type Part Number Description 
SCSI KZPAA-AA PCI-SCSI host bus adapter 
Network DE450-CA PCI NIC (TP, TW, AUI) 
Network DE500-BA PCI NIC (TP) 

Table Notes 


« TheSN-PBXGB-AA (TGA2 PowerStorm 3D30) video card will 
work behind a bridge in multiple configurations if the first 
card is within the primary bus. For restrictions on jumper 
settings and X server DMA for the PowerStorm 3D30 card, 
see Section 1.1.4.2. 


e When used with EBM2n SBCs, the SN-K ZPBA-CA (PCI-SCSI 
Ultra Wide adapter) requires the following console parameter 
to be set: 


>>> set pci prefetch SMS 


1.1.4.2 PBXGB-AA (TGA2 PowerStorm 3D30) Video Card Restrictions 


The following restrictions apply to the PBXGB-AA (TGA2 PowerStorm 
3D30) video card (listed in Table 1-2). 


1.1.4.2.1 EV5 Alias Jumper Setting (SMARTengine/Alpha 21264 and EBM2n Only) 


For SMARTengine/Alpha 21264 and EBM 2n SBCs only, you must set the 
EV5 Alias jumper on the PowerStorm 3D30 card to On. 


1.1.4.2.2 VGAEN Jumper Settings 


Only one PowerStorm 3D30 card can have its VGAEN jumper set to On. 
This card must be positioned in a primary PCI slot for the SRM Consoleto 
be displayed. All other PowerStorm 3D30 cards must have their VGAEN 
jumpers set to Off but may be positioned in any PCI slot. For more 
information about the jumpers, see the PBXGB-AA/ CA PCI Graphics Option 
Owner's Guide, provided with the card. 


1.1.4.2.3  X Server DMA Writes Must Be Disabled for Some Configurations 


Some configurations of PowerStorm 3D30 cards on SMARTengine/Alpha 
21264, EBM 2n, and EBM4n SBCs require that you disable X server direct 
memory access (DMA) write operations. Specifically, you must disable these 
operations if the system contains multiple PowerStorm 3D30 cards, or if 
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any PowerStorm 3D30 graphics card is installed behind the PCI -to-PCl 
bridge (PPB). 


The general procedure for disabling X server DMA write operations is as 
follows: 


1. 


Bring the system to single-user mode. 

If you are able to use the shutdown command, execute the following 
command as superuser: 

# /usr/sbin/shutdown +2 "Disabling graphics DMA writes" 


If you cannot use the shut down command (for example, if the X server 
on the video card is hung), you must halt your system by pressing the 
hardware halt button and then reboot your system to single-user mode 
by entering the following commana: 


>>> boot -fls 
Mount all local file systems. 


After your system is in single-user mode, mount all of your local file 
systems by entering the following command: 


# bcheckre 


Change the directory to /usr/var/X11 by entering the following 
command: 


# ed /usr/var/X11 


Save a copy of the Xserver.conf file by entering a command such 
as the following: 


# cp Xserver.conf Xserver.conf.old 


Edit the Xserver.conf file toadd the text -I -ffbDoDMA 4 tothe 
command line arguments section. For example, if the command line 
arguments section is in its initial default state, it appears as follows: 
! you specify command line arguments here 
args < 

-pn 
a 


Insert the text -I -ffbDoDMA 4 after -pn as follows: 


! you specify command line arguments here 
args < 
-pn -I -ffbDoDMA 4 
on 
Return the system to multiuser mode by executing the following 
command: 


# anit 3 


OEM Platform Requirements and Restrictions 1-5 


With this change, the video card and X server will run correctly on the SBC 
in multiuser mode. 


1.1.4.3 Operator Control Panel and Watchdog Timer Supported Only in Hardware 
and Firmware 


The operating system does not support the operator control panel or 
watchdog timer. These server management features are supported only 
in the hardware and the firmware. 


1.1.4.4 IDE Device Mapping Potentially Impacts 21264 SBC Upgrades 


The operating system identifies the IDE controllers on the 
SMARTengine/Alpha 21264 SBC as SCSI devices, which affects the naming 
of all other SCSI devices in the system. Even though the operating system 
does not support IDE drives on the 21264 SBC, the |DE controllers are 
configured during the system boot, causing the disk numbering to be shifted 
as if two SCSI controllers were added to the configuration. 


This is not a significant issue for deploying new systems on the 21264 SBC or 
for SBC upgrades performed with a new operating system installation, but it 
can cause problems for SBC upgrades performed without a new operating 
system installation. 


The altered naming of SCSI devices can create problems with /etc/fstab 
file entries and Logical Storage Manager (LSM) features that rely on a 
previous installation’s device naming. 


After a 21264 SBC upgrade, if the existing system disk has been renumbered 
(for example, from rzo to rz16), the existing system will not boot from the 
existing system disk. The root, usr, and swap partitions to which fstab 
points no longer exist. To resolve the problem, you must edit the fstab file, 
changing device name references (for example, from rzo torz1é6). As the 
swap partition is not accessible, the root partition cannot be made writable. 
Thus you must modify the fstab file before the existing system is upgraded, 
or you must boot the Tru64 UNIX distribution CD-ROM in single-user 
mode to edit the file. 


If LSM features were used in connection with the existing operating system 
installation, further steps may be necessary. After a 21264 SBC upgrade, 
LSM volume data on any renumbered disk no longer matches the physical 
configuration. In particular, if a system disk containing LSM volumes is 
renumbered, changes similar to the following will be required before the 
upgraded system will boot into multiuser mode: 


1. Beforethe SBC upgrade, disable LSM volumes on the system disk; see 
thevolunroot -a command in the volunroot (8) reference page. You 
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must also edit /etc/fstab toremovethe LSM mount point. (See the 
fstab(4) reference page.) 


Update /etc/fstab entries to reflect device name changes resulting 
from the SBC upgrade. As previously mentioned, you must make these 
changes either before the SBC upgrade or while booted in single-user 
mode from the operating system CD-ROM. 


After the SBC upgrade, reconvert disk partitions on the system disk to 
LSM volumes as desired. (See the volencap(8) reference page.) 


1.1.5 Configuring PCI/SA Modular 8-Headed Graphics Systems 


This section describes how to configure a PCI/ISA modular system to run 
8-headed graphics. 


You can configure PCI/ISA platforms that contain a EBM 2n-AZ Alpha 
PICMG single-board computer (SBC) and multiple PowerStorm 3D30 
graphics cards to run multiheaded graphics, controlling up to eight monitors 
at atime 


1.1.5.1 Hardware and Software Requirements 


Running 8-headed graphics requires the following: 


An EBM 2n-AZ Alpha PICMG SBC and eight PowerStorm 3D30 graphics 
cards within a fully configured PCI/ISA system. 

A PCI/ISA backplane and enclosure with at least 10 PCI slots, 512 MB 
main memory, a supported Ethernet card, and all the other storage 

and I/O options normally required for such a system. (See the current 
PCI/ISA components order configuration guide.) 

Correct card placement: the SBC occupies an SBC slot and the graphics 
cards occupy eight PCI slots, in the order described in Section 1.1.5.2. 


Version 4.0E or higher of the operating system. 


The latest DMCC SRM code from Version 5.2 or higher of the Firmware 
CD-ROM. 


The following PCI/ISA system configuration has been qualified for running 
8-headed graphics under Tru64 UNIX: 


PCI/ISA Alpha 21164/366 MHz SBC with 2 MB cache and Tru64 UNIX 
license (EBM21-AZ) 


512 MB main memory (2 x EBXMA-HC, for a total of four 128 MB 
DIMMs) 


Desktop enclosure with 14-slot PICMG backplane: 10 PCI, 31SA, 1 SBC 
(ETM33-BD) 


OEM Platform Requirements and Restrictions 1-7 


e Eight PowerStorm 3D30 graphics cards (8 x SN-PBXGB-AA) 
« PCI Ethernet card (DE450-CA) 
¢ PCI fast/narrow SCSI controller (K ZPAA-AA) 


¢« Mandatory or associated options such as floppy drives, hard drives, 
CD-ROM drives, cable kit for PICMG enclosure, and power cord 


e Tru64 UNIX Version 4.0E or higher 
¢ DMCC SRM code from the Version 5.2 Firmware CD-ROM 


1.1.5.2 Hardware Setup 


When you configure the PCI/ISA 15-slot platform for 8-headed graphics, 
placement of the graphics cards is critical. 


The qualified configuration (described in Section 1.1.5.1) uses an ETM33-BD 
desktop enclosure with a 14-slot backplane. Within that enclosure, the PCI 
option cards must be placed into PCI slots in top-to-bottom order as follows: 


¢ Secondary 32-bit PCI bus connectors 
- KZPAA SCSI card 
- PowerStorm graphics card: SCREEN 2 
- PowerStorm graphics card: SCREEN 3 
- PowerStorm graphics card: SCREEN 4 
- DE450 Ethernet card 
- PowerStorm graphics card: SCREEN 5 
- PowerStorm graphics card: SCREEN 6 
- PowerStorm graphics card: SCREEN 7 
¢ Primary 64-bit PCI bus connectors 
- PowerStorm graphics card: SCREEN 0 (VGA ENABLED) 
- PowerStorm graphics card: SCREEN 1 


For reference, the power connector is situated above the PCI slots, and the 
SBC and 1SA connectors are below. 


All PowerStorm cards must have their Alias jumper IN and VGA EN jumper 
OUT, except the SCREEN 0 card, which must be VGA-enabled. 


1.1.5.3 Software Setup 


After you complete hardware configuration for the 8-headed system, you can 
set up the operating system to operate the eight screens as one row of eight 
screens (8x1) or two rows of four screens (4x2). 
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By default in a multiheaded configuration, the screens are operated as 8x1. 
To set up the screens in a 4x2 combination, you must edit your system's X 
Window System server configuration file, /usr/var/X11/Xserver.conf. 
Instructions for editing this file to customize the X server configuration are 
provided in the Xserver(1X) reference page. 


To set up 4x2 operation, you need to specify -edge_ top, -edge_ bottom, 
-edge right, and -edge_left command line arguments that arrange and 
attach the screens as you wish them. Each argument takes scri and scr2 
values, which are the numbers of the screens you are attaching. 


For example, you could arrange the eight screens as follows: 


ZK-1559U-Al 


To achieve this combination, add the appropriate command line arguments 
tothe command line arguments section of Xserver. conf, as follows: 


! you specify command line arguments here 


args < 
-pn 
-edge_ topo 4 -edge_topl 5 -edge_top2 6 -edge_top3 7 
-edge_bottom4 0 -edge_ bottom5 1 -edge_bottom6é 2 -edge_bottom7 3 
-edge_rightoO 1 -edge_right1 2 -edge_right2 3 
-edge_right4 5 -edge_right5 6 -edge_right6 7 
-edge_leftl1 0 -edge_left2 1 -edge_left3 2 
-edge_left5 4 -edge_left6é 5 -edge_left7 6 


1.1.6 Writing PCl Bus Device Drivers 


For information about writing PCI bus device drivers, see the Tru64 UNIX 
Device Driver Kit (DDK), which is orderable separately from the base 
operating system. 


You can browse a subset of device driver writing materials in the Library 
section of the Compaq Tru64 UNIX web site, currently located at: 


http://www.unix.digital.com/faqs/publications/pub_page/ devdoc list.html 
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Note 


The Library section of the Compag Tru64 UNIX web site also 
provides the latest DDK technical updates. DDK customers 
should check for potential DDK technical updates whenever they 
install a new version of the operating system. 


1.2 Alpha VME 4/nnn and 5/nnn Single-Board Computers 
(EBVnn) 


TheAlpha VME 4/nnn and 5/nnn platforms are members of a family of 
VME bus-based single-board computers (SBCs). The part numbers for these 
SBCs are EBV 14-xx (Alpha VME 4/nnn) and EBV16-xx (Alpha VME 5/nnn). 


Support for the VIP/VIC64 VME bus adapter on the Alpha VME 4/nnn and 
5/nnn SBCs is consistent with the support for this adapter on AXPvme SBCs 
and Alpha VME 2100 systems. 


The following notes are specific to Alpha VME 4/nnn and 5/nnn SBCs. 


1.2.1 Verifying CPU Version 


You can use the sizer utility to identify the Alpha VME 4/nnn and 5/nnn 
SBCs. The sizer -c command displays the following output for Alpha 
VME 4/224 and 4/288 SBCs: 


sysname> sizer -c 
cpu "DECALPHAVME 224" 


The sizer -c command displays the following output for Alpha VME 5/352 
and 5/480 SBCs: 


sysname> sizer -c 
cpu "DECALPHAVME 320" 


1.2.2 Firmware Requirements 


Before installing the operating system, make sure that your system has the 
correct firmware version. The minimum firmware versions required are 
Version 1.2 or higher for an Alpha VME 4/224 or 4/288 SBC, and Version 
1.0 or higher for an Alpha VME 5/352 or 5/480 SBC. If you have an earlier 
firmware version, update your firmware before installing the operating 
system software. For information on how to update your firmware, see the 
firmware documentation. 


To determine the version of firmware on your system, enter the following 
command at the console firmware prompt: 
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>>> show version 


1.2.3 Installing Tru6é4 UNIX 


For information about installing the operating system on an Alpha 
VME 4/nnn or 5/nnn SBC, see the Tru64 UNIX Installation Guide The 
Installation Guide provides platform-specific instructions for booting. 


1.2.4 Configuring the VMEbus 


For information about configuring the VMEbus for an Alpha VME SBC, 
see Chapter 2. 


For information about setting up a VMEbus backplane-based network in 
which Alpha VME SBCs operate as Ethernet nodes, see Chapter 3. 


1.2.5 Restrictions and Known Problems 


The following restrictions apply to Alpha VME 4/nnn and 5/nnn SBCs. 


1.2.5.1 VMEbus Autovectors Not Supported 
The Alpha VME 4/nnn and 5/nnn SBCs do not support VME bus autovectors. 


1.2.5.2 Network Port Termination Required 


An Alpha VME 4/nnn or 5/nnn SBC that has the network configured in an 
up state must have its external network connection properly terminated. If 
the network connection is unplugged or not properly terminated, then the 
network software will periodically time out and perform a network reset. 
This is normal for an unterminated Alpha VME system. However, it will 
cause high system latencies during the reset period, resulting in delays of 
about 10 milliseconds, which can affect the realtime performance of the 
system. 


Note that a loopback connector is not sufficient to terminate the network 
connection. 


1.2.5.3 Some TGA Video Card Configurations Require Disabling X Server DMA 
Writes 


To use TGA video cards in someAlpha VME configurations, you must disable 
X server direct memory access (DMA) write operations. This restriction 
applies to the following configurations: 


¢ EBVXG (TGA) video cards on Alpha 4/nnn and 5/nnn SBCs; note that 
the EBVXG video card is always installed behind the PCI-to-PCI bridge 
(PPB) 
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¢ TGA8 and TGA24 video cards on Alpha 5/nnn SBCs 


The general procedure for disabling X server DMA write operations is as 
follows: 


1. Bring the system to single-user mode. 
If you are able to use the shutdown command, execute the following 
command as superuser: 
# /usr/sbin/shutdown +2 "Disabling graphics DMA writes" 


If you cannot use the shutdown command (for example, if the X server 
on the video card is hung), you must halt your system by pressing the 
hardware halt button and then reboot your system to single-user mode 
by entering the following commana: 


>>> boot -fls 

2. Mount all local file systems. 
After your system is in single-user mode, mount all of your local file 
systems by entering the following command: 
# bcheckre 

3. Change the directory to /usr/var/X11 by entering the following 
command: 
# ed /usr/var/X11 

4. Savea copy of the Xserver.conf file by entering a command such 
as the following: 
# cp Xserver.conf Xserver.conf.old 


5. Edit the xserver.conf file toadd the text -I -ffbDoDMA 4 tothe 
command line arguments section. For example, if the command line 
arguments section is in its initial default state, it appears as follows: 


! you specify command line arguments here 
args < 

-pn 
a 


Insert the text -I -ffbDoDMA 4 after -pn as follows: 
! you specify command line arguments here 
args < 


-pn -I -ffbDoDMA 4 
> 
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6. Return the system to multiuser mode by executing the following 
command: 


# init 3 
With this change, the video card and X server will run correctly on the SBC 


in multiuser mode. 


1.2.5.4 Master Block Transfer Restrictions 


For restrictions that apply to performing VMEbus master block transfers 
(MBLTs) using hardware DMA engines, see the discussion of MBLTs 

in Section 2.2.8 (VIP/VIC-based Alpha VME SBCs) or Section 2.3.11 
(UNIVERSE II-based Alpha VME SBCs). 


1.2.6 Writing VMEbus Device Drivers 


For information about writing VMEbus device drivers, see the Tru64 UNIX 
Device Driver Kit (DDK), which is orderable separately from the base 
operating system. 


You can browse a subset of device driver writing materials in the Library 
section of the Compaq Tru64 UNIX web site, currently located at: 


http://www.unix.digital.com/faqs/publications/pub_page/ devdoc list.html 


Note 


The Library section of the Compag Tru64 UNIX web site also 
provides the latest DDK technical updates. DDK customers 
should check for potential DDK technical updates whenever they 
install a new version of the operating system. 


1.3 AXPvme Single-Board Computers 
The following notes are specific to the AXPvme single-board computers 


(SBCs). The part numbers for these SBCs include EBV 10-xx (AXPvme 100) 
and EBV12-xx (AXPvme 166 and 230). 


1.3.1 Firmware Upgrade Required 


AXPvme SBCs must upgrade to Version 17.0 or higher of the AXPvme 
firmware torun the current version of the operating system. 
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1.3.2 Master Block Transfer Restrictions 


The following restriction applies to the VIP/VIC adapter used on AXPvme 
SBCs and Alpha VME 2100 systems. Performing master block transfers 
(MBLTs) with a data width of D64 can produce unpredictable results in the 
following cases: 


¢ If D64 slave access is performed before memory has been mapped to 
the VMEbus. 


e If memory access does not coincide with the appropriate access mode, 
such as attempting user access to memory specified as supervisory-mode 
access. 


¢« |ftheAXPvme SBC or Alpha VME 2100 system is a VMEbus interrupter 
and is targeted for D64 slave access. The interrupt vector presented 
by the VME bus interrupter may not be the vector specified in the 
vba_post_irg routine. 


Memory must be mapped to the VMEbus prior to D64 slave access. 
Access to memory must coincide with the appropriate access mode. If 
supervisory-mode access is specified when memory is mapped, memory 
accesses must use supervisory mode. | f user-mode access is specified, both 
supervisory and user access are allowed. 


See Section 2.2.7 and Section 2.2.8 for more information on slave and master 
block transfers, including additional restrictions that apply to MBLTs. 
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Configuring the VMEbus for Alpha VME 
Systems 


This chapter explains how to configure the VMEbus for OEM platforms 
running Tru64 UNIX. The chapter provides an overview followed by sections 
that address groups of platforms based on their VMEbus adapter type: 


¢ VMEbus support overview (Section 2.1) 
¢ Configuring VIP/VIC-based Alpha VME SBCs (Section 2.2) 
¢ Configuring UNIVERSE I|-based Alpha VME SBCs (Section 2.3) 


2.1 VMEbus Support Overview 


The Tru64 UNIX operating system includes a generic VME bus interface 
layer that provides customers with a consistent interface to VME bus devices 
across Alpha workstation and server platforms and Alpha VME single-board 
computers (SBCs). 

The operating system supports the following PCI/VME bus adapters: 

¢ UNIVERSE II PCI64-to-VME 64 adapter 

¢ VIP/VIC PCI32-to-VME 64 adapter 

¢ DWP64 PCI32-to-VME 64 adapter 

¢ DWPVC PC132-to-VME 32 adapter 

Alpha VME SBCs provide an integrated PCI/VME bus adapter: either 


VIP/VIC or UNIVERSE II. The DWP64 and DWPVC adapters are provided 
in layered product kits for use with Alpha workstation and server platforms. 


For information about the VME bus-based systems supported by the 
operating system, see the Tru64 UNIX Software Product Description (SPD). 


This chapter provides information about configuring the VMEbus on the 
Alpha VME family of SBCs. To configure a VME bus backplane (vb) network 
with Alpha VME SBCs in the same backplane communicating as network 
nodes, see Chapter 3. 


To write VME bus device drivers, you must obtain the Tru64 UNIX Device 
Driver Kit (DDK), which is available separately from the base operating 
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system. The DDK provides a detailed VME bus device driver example that 
you can run on the Alpha VME SBCs. 


To write VME bus device drivers for Alpha workstation and server platforms 
with DWP64 or DWPVC adapters, you must have the associated adapter 
driver software and documentation in addition to the DDK. Be sure to 
check for the required processor and hardware configurations. For more 
information about the DWP64 and DWPVC adapters, see the PCI 32/VME 64 
Adapter Driver SPD and the PCI/VME Adapter Driver SPD. 


2.2 Configuring VIP/VIC-Based Alpha VME SBCs 


This section describes how to set up VIP/VIC-based Alpha VME systems for 
use on the VME bus, including how to modify attributes of the vba_vipvic 
kernel subsystem. 


VMEbus setup allows you to run the operating system on the following 
VIP/VIC-based AXPvme and Alpha VME systems: 


« AXPvme single-board computers (SBCs) 
¢ Alpha VME 4/224 and 4/228 SBCs 

¢ Alpha VME 5/352 and 5/480 SBCs 

¢ Alpha VME 2100 system 


For information about installing the operating system on the listed systems, 
see the Installation Guide 


For information about setting up UNIVERSE ||l-based Alpha VME systems 
for use on the VMEbus, see Section 2.3. 


This section addresses the following topics relating to the use of the VME bus 
on the listed systems: 


¢ Configuring the vba_vipvic subsystem (Section 2.2.1) 

¢ Configuring VMEbus A32 and A24 address spaces (Section 2.2.2) 
¢ Configuring the VMEbus A16 address space (Section 2.2.3) 

¢ Configuring VMEbus interrupts (Section 2.2.4) 

e Using VMEbus hardware byte-swapping modes (Section 2.2.5) 


e Sharing memory between big endian and little endian processors 
(Section 2.2.6) 


¢ Performing VMEbus slave block transfers (Section 2.2.7) 


¢ Performing VMEbus master block transfers with local DMA 
(Section 2.2.8) 
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e Using the realtime interrupt-handling routine rt_ post callout 
(Section 2.2.9) 


2.2.1 Configuring the vba_vipvic Subsystem 


This section describes how to configure the vba_vipvic kernel subsystem 
in order to prepare VIP/VIC-based AXPvme and Alpha VME systems for 
use on the VMEbus. 


You configure the VIP/VIC adapter by examining the default (or 
current) attributes supplied for the vba_vipvic subsystem, determining 
which attributes (if any) you want to change, then modifying 

the /etc/sysconfigtab file on your machine. After modifying 
/etc/sysconfigtab, you must shut down and reboot the system. 


Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain private 
sysconfigtab file fragments for vba_vipvic attributes and use 
sysconfigdb switches toadd (-a -f£), delete (-d), or merge (-m 
-£) vba_vipvic attribute values. The example in Section 3.6 
illustrates this approach. The sys_attrs(5) reference page 
provides additional guidelines for editing kernel subsystem 
attributes. You must always reboot after changing vba_vipvic 
subsystem attributes. 


Common modifications to the vba_vipvic subsystem default attributes 
are to reconfigure the A32, A24, and A16 address spaces. For example, 
you could use sysconfigdb to edit the following modifications into 


/etc/sysconfigtab: 
vba_vipvic: 
A32_ Base = 0x10000000 
A32 Size = 0x08000000 
A24 Base = 0x00A00000 
A24 Size = 0x200000 
A16 Base = 0x00000000 


In this example, the A24 inbound DMA window base address is modified 
from the default OxO0C 00000 to Ox00A0000; the A24 window size from the 
default 4 MB to 2 MB; and the A116 interprocessor communication base 
address from the default 0x00000100 to 0x00000000. 
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You can modify values for the following VIP/VIC adapter attributes; each list 
item corresponds to a later subsection: 


VMEbus request level (Section 2.2.1.1) 

VIC arbitration mode (Section 2.2.1.2) 

VMEbus fairness timer value (Section 2.2.1.3) 

Local bus and VMEbus timeout periods (Section 2.2.1.4) 

VMEbus release mode (Section 2.2.1.5) 

System controller VMEbus resets (Section 2.2.1.6 and Section 2.2.1.7) 
VIC master write posting (Section 2.2.1.8) 

VMEbus DMA interleave gap (Section 2.2.1.9) 

VMEbus DMA read limit (Section 2.2.1.10) 

VMEbus DMA write limit (Section 2.2.1.11) 

DMA method (hardware or emulated) for SMP systems (Section 2.2.1.12) 


You can also modify the following values for the A32, A24, and A16 address 
spaces that the VME bus hardware architecture defines; each list item 
corresponds to a later subsection: 


A32 and A24 overlapping address configuration (Section 2.2.2.1) 
A32 and A24 DMA inbound window sizes (Section 2.2.2.2) 

A32 DMA inbound window base address (Section 2.2.2.3) 

A24 DMA inbound window base address (Section 2.2.2.4) 

A16 base for interprocessor communication facilities (Section 2.2.3) 


Table 2-1 lists the defaults supplied for various VMEbus parameters. The 
default values specified should provide proper VMEbus operation for most 
applications. Be careful when modifying these values; not all adapters 
support all fields. 


Table 2-1: VIP/VIC VMEbus Adapter Defaults 


Parameter Default Meaning 
VME_Br_Lev 0x03 Bus request level 3 for master cycles 
VIC_Arb_Mode 0x00 Arbitration mode is round robin 
VME_Fair_ Req 0x00 VMEbus fair requester disabled 
VIC_Loc_Bus_To 0x05 Local bus timeout period is 256 
microseconds 
VME_Bus_To 0x06 VMEbus timeout period is 512 
microseconds 
VIC_Rel_Mode 0 Release mode is release on request (ROR) 
VIC_Syscon 1 System controller VMEbus reset 
is enabled 
VIc_Wrt_Post 0 Disable VIC master write posting 
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Table 2-1: VIP/VIC VMEbus Adapier Defaults (cont.) 


Parameter Default Meaning 
VIC_DMA Intrlv 15 DMA interleave gap is 3.75 microseconds 
(value * 250 nanoseconds) 
Lmt_DMA Rd No DMA read limit 
Lmt_DMA_Wrt No DMA write limit 
Frce_Hw_DMA Do not force hardware DMA engine 
on SMP systems 
A32 Base 0x08000000 A32 inbound DMA window base address 
A32 Size 0x8000000 A32 window size (128 MB) 
A24_ Base 0x00C 00000 A24 inbound DMA window base address 
A24 Size 0x400000 A24 window size (4 MB) 
Al6 Base 0x00000100 A16 interprocessor communication 
base address 
Al6 Mask 0x00000000 A16 interprocessor communication mask 
A24 A32 Ovrlap 1 Inbound A24/A 32, if same space, overlap 


Table 2-2 lists VMEbus interrupt parameters and their initial defaults. 
These defaults are later overwritten by system priority level (SPL) values 
supplied by the platform. See the SPL values listed in Table 2-3, or query 
the values at run time using the command sysconfig -q vba_vipvic. 


Table 2-2: VIP/VIC VMEbus Interrupt Initial Defaults 


Parameter Default Meaning 
Irq0_ SPL 3 VMEbus IRQ level to system SPL map 
Irql_SPL 3 VMEbus IRQ 1toSPL SPLDEVLOW 
Irq2_SPL 3 VMEbus IRQ 2 toSPL SPLDEVLOW 
Irg3_SPL 3 VMEbus IRQ 3 toSPL SPLDEVLOW 
Irgq4_ SPL 3 VMEbus IRQ 4toSPL SPLDEVLOW 
Irg5 SPL 3 VMEbus IRQ 5 toSPL SPLDEVLOW 
Irg6_ SPL 3 VMEbus IRQ 6 toSPL SPLDEVLOW 
Irq7_SPL 3 VMEbus IRQ 7 toSPL SPLDEVLOW 
Adapt Blk SPL 3 Adapter resource blocking SPL 
SPLDEVLOW 
DMA_Access_ Space 0 Adapter MBLT I/O access: sparse 
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2.2.1.1 Specifying the VMEbus Request Level 


You can specify one of the following values for the VME bus request 
level (parameter VME_Br_ lev). The value is stored in the VIC64 
Arbiter/Requester Configuration Register (ARCR). 


0x00 VMEbus request level BRO 
0x01 VMEbus request level BR1 
0x02 VMEbus request level BR2 
0x03 VMEbus request level BR3 (default) 


2.2.1.2 Specifying the VIC Arbitration Mode 


You can specify one of the following values for the VME bus arbitration mode 
(parameter VIC_Arb Mode). The VMEbus arbitration mode is stored in the 
VIC64 Arbiter/Requester Configuration Register (ARCR). This parameter is 
applicable only when the VMEbus adapter is configured to be the system 


controller. 
0x00 VIC performs round-robin VMEbus arbitration (default) 
0x01 VIC performs priority VMEbus arbitration 


2.2.1.3 Specifying the VMEbus Fairness Timer Value 


You can specify one of the following values for the Arbiter/Requester fair 
request timeout (parameter VME Fair Req). Thefair request timeout value 
is stored in the VIC64 Arbiter/Requester Configuration Register (ARCR). 


0x00 Fairness disabled (default) 

0x01 Fair request timeout =2 microseconds 
0x02 Fair request timeout = 4 microseconds 
0x03 Fair request timeout = 6 microseconds 
0x04 Fair request timeout = 8 microseconds 
0x05 Fair request timeout = 10 microseconds 
0x06 Fair request timeout = 12 microseconds 
0x07 Fair request timeout = 14 microseconds 
0x08 Fair request timeout = 16 microseconds 
0x09 Fair request timeout = 18 microseconds 
Ox0A Fair request timeout = 20 microseconds 
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0Ox0B Fair request timeout = 22 microseconds 


Ox0C Fair request timeout = 24 microseconds 
0x0D Fair request timeout = 26 microseconds 
Ox0E Fair request timeout = 28 microseconds 
OxOF Fair request timeout = none 


2.2.1.4 Specifying Bus Timeout Periods 


You can specify one of the following values for the local bus timeout 
period (parameter VIC_Loc Bus _ To) and for the VMEbus timeout period 
(parameter VME_Bus_ To). Each value is stored in the VIC64 Transfer 
Timeout Register (TTR). The local bus timeout period must be shorter than 
the VMEbus timeout period. 


0x00 Timeout = 4 microseconds 

0x01 Timeout = 16 microseconds 

0x02 Timeout = 32 microseconds 

0x03 Timeout = 64 microseconds 

0x04 Timeout = 128 microseconds 

0x05 Timeout = 256 microseconds (default for local bus) 
0x06 Timeout =512 microseconds (default for VME bus) 
0x07 Timeouts disabled 


2.2.1.5 Specifying the VMEbus Release Mode 


You can specify one of the following values for the release mode (parameter 
VIC_Rel_ Mode). The release-mode value is stored in the VIC64 Release 
Control Register (RCR). 


0 Release on request (ROR) — the default 
1 Release when done (RWD) 


2.2.1.6 Specifying System Controller VMEbus Resets 


You can specify one of the following values to indicate whether or not the 
adapter should issue VME bus resets if it is the system controller (parameter 
VIC_Syscon). 


For AXPvme SBCs and Alpha VME 4/nnn and 5/nnn SBCs, in addition to 
specifying a value from this list, you must set the configuration switches to 
indicate whether or not the SBC is the VMEbus system controller. See the 
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SBC’s installation guide for information on setting the module configuration 
switches. 


TheAlpha VME 2100 adapter is always the VMEbus system controller. 
There are no module configuration switches to disable it from being the 
system controller. 


The VMEbus backplane must have only one system controller. The system 
controller must be electrically the first module in the VME bus backplane 
and in most systems must be in the first VMEbus slot. 


0 Do not issue VMEbus resets if system controller 


1 Issue VMEbus resets if system controller (default) 


The values specified interact with the VMEbus initialization code to 
determine whether a VMEbus reset is issued when the VME bus adapter is 
being configured. If the value is set to 1 and the system being booted is 
the system controller, as determined by the VMEbus initialization code, a 
VME bus reset is issued. If you do not want a VMEbus reset issued during 
VMEbus adapter configuration, set the value to 0 (zero). These values 
pertain only to the system controller. 


If the system controller is configured to issue a VME bus reset during adapter 
initialization, and other processor modules are installed in the VME bus 
backplane, boot the system controller first to allow devices and processor 
modules to perform their bus reset actions. 


2.2.1.7 Special Considerations for VMEbus Resets 


The system controller should always be the initiator of VMEbus resets. 
However, under certain error conditions, other VMEbus adapter modules 
may invoke a VMEbus reset. Modules installed in the VMEbus backplane 
react to bus resets differently. Some modules, if configured, perform a 
module reset. Some may have their VMEbus interface reset to a power-up 
state without notification to the operating system. This could leave the 
VMEbus adapters in an unconfigured state, cause unwanted effects to 
the operating system and its device drivers, and cause VME bus errors to 
occur. Other VMEbus adapters on the VMEbus may accept VME bus resets 
and attempt to reconfigure themselves to the hardware context they were 
running before the bus reset occurred. However, device drivers expecting 
interrupts may not receive them and I/O hardware operations may be 
canceled by the VMEbus reset without notification to the device driver. 
There is also a potential for data corruption to occur when the VME bus 
adapter is reset during an I/O operation. 


It is recommended that the system controller be the initiator of VMEbus 
resets during adapter initialization. If the system controller is not controlled 
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by a processor, then a power-up sequence should cause all VMEbus adapters 
and devices to be reset. All modules on the VMEbus should perform a 
module reset upon detection of a bus reset. VMEbus adapters that are not 
the system controller and that are running an operating system should be 
shut down in an orderly fashion prior to the system controller being booted. 
These VMEbus adapters should be rebooted after the system controller has 
been booted, providing that the system controller is to be used and controlled 
by a processor. 


For Alpha VME 2100 systems, the VME bus adapter can be the initiator 
of VMEbus resets only. Upon receipt of a bus reset, its VMEbus interface 
(VIC64) is reset. The reset state of the VME bus interface (VI C64) is not 
the VMEbus adapter’s configured state. The operating system and device 
drivers are not notified that a bus reset has occurred. If the adapter is 
accessed or if an |/O operation is invoked following a bus reset, the access 
may result in an adapter error, misoperation, or system crash. 


For AXPvme SBCs and Alpha VME 4/nnn and 5/nnn SBCs, it is 
recommended that nodes that are not the system controller have their 
module configuration switch 3 set to Closed (resets the SBC module in 
response to a VMEbus reset signal). When the VMEbus is reset, and 
the module switch is set to accept a VMEbus reset, nonsystem controll er 
modules take a boot action and are reset to a powered state. 


If the SBC module configuration switch 3 is set to Open (does not reset the 
SBC module in response toa VME bus reset signal), the VMEbus adapter 
software will receive a VME bus reset interrupt upon detection of a bus reset. 
The VME bus reset signal initializes the VMEbus adapter (VIC64) to its 
power-up state. The VMEbus reset interrupt service interface displays the 
following message on the console terminal: 


vbaO reset_inter: VMEbus reset detected 


The interrupt service interface then initializes the VMEbus adapter to its 
defaults and enables any previously enabled interrupt enable bits. 


Do not set the SBC module configuration switch 3 to Open without 
considering the following side effects of receiving a VMEbus reset: device 
drivers expecting interrupts may not receive them and I/O hardware 
operations may be canceled by the VME bus reset without notification to the 
device drivers. There is potential risk of data corruption depending upon I/O 
activity at the time a bus reset occurred. 


2.2.1.8 Specifying VMEbus Master Write Posting 


Master write posting is not currently supported. Do not change the value 
from the default of 0 (zero) or unpredictable results may occur. 
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2.2.1.9 Specifying the VMEbus DMA Interleave Gap 


You can specify one of the following values for the DMA interleave gap 
(parameter VIC_DMA_Intr1v), which is the time period between master 
block transfer (MBLT) DMA bursts. The DMA interleave gap value is stored 
in the VIC64 Block Transfer Control Register (BTCR) at the start of a master 
block transfer DMA. This parameter is applicable only when you use the 
VMEbus adapter’s hardware DMA engine to perform the DMA. 


15 Interleave gap =3.75 microseconds (default) 
14 Interleave gap = 3.50 microseconds 
13 Interleave gap = 3.25 microseconds 
12 Interleave gap = 3.00 microseconds 
11 Interleave gap = 2.75 microseconds 
10 Interleave gap = 2.50 microseconds 
9 Interleave gap = 2.25 microseconds 
8 Interleave gap = 2.00 microseconds 
7 Interleave gap = 1.75 microseconds 
6 Interleave gap = 1.50 microseconds 
5 Interleave gap = 1.25 microseconds 
4 Interleave gap = 1.00 microseconds 
3 Interleave gap = 0.75 microseconds 
2 Interleave gap = 0.50 microseconds 
1 Interleave gap = 0.25 microseconds 
0 Interleave gap = 0.00 microseconds 


2-10 Configuring the VMEbus for Alpha VME Systems 


2.2.1.10 


2.2.1.11 


Caution 


You must not specify the value 0 (zero) if D64 master block 
transfers are to be performed. Unpredictable errors and possible 
data corruption may result if you specify 0 (zero) with D64 
transfers. 


During the DMA interleave gap, stalled or new programmed I/O (PIO), 
VMEbus IACK cycles, or slave DMAs may obtain the bus to perform the 
required |/O operation. The VIC64 is enabled for dual paths to allow these 
1/O operations to occur during the DMA interleave gap. Changing this 
parameter arbitrarily may cause unwanted side effects. 


Decreasing the value from the default increases DMA throughput. However, 
as the number approaches 0 (zero), outstanding PIO operations, VMEbus 
IACKs, and slave DMAs may be held off from obtaining the bus until the 
DMA in progress is completed. These operations might have occurred during 
the DMA interleave gaps if the default value had been used. 


Specifying a small DMA interleave gap may result in PCI retry timeouts, 
poor PIO performance, increased interrupt response time, other PCI 
transactions being held off, and possible system time loss. Beware of these 
side effects when specifying a new value for the DMA interleave gap. 


Specifying Limits on VMEbus DMA Reads 


You can specify one of the following values to enable or disable an 8 KB limit 
on DMA read operations (parameter Lmt_DMA_Rd). Placing an 8 KB limit 
on DMA reads can enhance throughput when the bus is busy. Transfers 
relinquish the bus after each 8 KB or less. 


0) No DMA read limit (default) 
1 Limit DMA reads to 8 KB or less 
Specifying Limits on VMEbus DMA Writes 


You can specify one of the following values to enable or disable an 8 KB limit 
on DMA write operations (parameter Lmt_DMA wrt). Placing an 8 KB limit 
on DMA writes can enhance throughput when the bus is busy. Transfers 
relinquish the bus after each 8 KB or less. 

0 No DMA write limit (default) 


1 Limit DMA writes to 8 KB or less 
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2.2.1.12 Specifying the DMA Method for SMP 


You can specify one of the following values to enable or disable use of the 
hardware DMA engine on an SMP system (parameter Frce Hw DMA). Note 
that in an SMP system, you would enable use of the hardware DMA engine 
only if the system was known to be quiescent, with no other PIO, DMA, or 
interrupt activity occurring on the bus. 


0 Use emulated DMA on SMP system (default) 
1 Force hardware MBLT on SMP system 


2.2.2 Configuring VMEbus A32 and A24 Address Spaces 


As part of configuring the vba_vipvic kernel subsystem, you can configure 
the VMEbus 32-bit address space (A32) and 24-bit address space (A24) for 
your system. A32 and A24 space are used for direct memory access (DMA) 
inbound windows. 


The A32 space has a maximum size of 4 GB and can be partitioned into 
32 128 MB windows. You can further partition each 128 MB window in 
increments as small as 16 MB. Valid window segments are 16, 32, and 64 
MB. 


TheA24 space has a maximum size of 16 MB, and the base address is always 
zero (Ox00000000). This means that you can partition the address space but 
cannot move it. The default window size is 4 MB and the base address for a 

window must be a multiple of the window size. The default inbound window 
is the top 4 MB of the 16 MB space. 


You can specify whether the A24 and A32 addresses can reside within the 
same addressing range or whether they must be unique. 


2.2.2.1 Specifying A32 and A24 Address Space Overlapping 


Read this section if the A32 direct memory access (DMA) inbound window 
will be configured with a base address of zero (OxO0000000), overlapping the 
A24 address space. A24 inbound windows are always configured within the 
first 16 MB of the 4 GB VMEbus address space. 


Typically, VMEbus A24 and A32 address spaces overlap each other such 
that addresses in each address space are unique to that address space. As 
an example, address 0x200 in A32 address space is not the same address as 
0x200 in A24 address space. This is the default configuration, selected if you 
leave the A24_A32 Ovrlap parameter at its default value of 1. 


You can configure some VME bus devices to recognize the same VME bus 
address in both A24 and A32 address spaces. These devices treat the two 


2-12 Configuring the VMEbus for Alpha VME Systems 


address spaces as a single entity. Consult the VME bus hardware device 
manuals to determine if any devices installed on the VME bus follow this 
model. If so, you must configure the autoconfiguration software to disallow 
A32 DMA allocations within the first 16 MB of VMEbus address space. 

If you do not do this, an A32 direct memory access to the first 16 MB of 
VMEbus address space by another VME bus device may not only select the 
AXPvme or Alpha VME module but also select the device that treats the 
address spaces as a single entity. 


Configure the first 16 MB of VMEbus address space as a single entity by 
setting the A24_A32 Overlap parameter to 0 (zero). 


The values for overlapping and unique address spaces are as follows. These 
values are valid only when the A32 and A24 address spaces are configured 
to overlap each other; that is, when the A32 base address equals zero 


(Ox00000000). 
0 A24 and A32 addresses must be unique 
1 A24 and A32 addresses can overlap each other (default) 


2.2.2.2 Configuring A32 and A24 Window Sizes 


You can specify the DMA inbound window size for the A32 address space 
(parameter A32_ Size) and the A24 address space (parameter A24 Size). 


If you specify an invalid base address in relation to a window size, the 
autoconfiguration code adjusts the base address to match the window size. 
The base address is adjusted downward to the next appropriate boundary 
for the window size. 


The window size values are as follows: 


0x10000 64 KB 

0x20000 128 KB 

0x40000 256 KB 

0x80000 512 KB 

0x100000 1024 KB (1 MB) 

0x200000 2048 KB (2 MB) 

0x400000 4096 KB (4 MB) [A24 default] 
0x800000 8192 KB (8 MB) 

0x1000000 16384 KB (16 MB) 
0x2000000 32768 KB (32 MB) 
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0x4000000 65536 KB (64 MB) 
0x8000000 131072 KB (128 MB) [A32 default] 


2.2.2.3 Specifying the A32 Base Address 


You specify the A32 base address using the A32_ Base parameter. The 
following table lists the values used for partitioning 128 MB windows in the 
A32 address space. Note that the base value is contained in bits 24 through 
31, with bits 27 through 31 indicating the window and bits 24 through 26 
indicating the partition size. 


Base (Bits 31-24) Bus Address (A32_Base) Bus Offset 


128 MB window: 


0000 0000 0x00000000 0 MB 
64 MB windows: 

0000 0000 0x00000000 0 MB 
0000 0100 0x04000000 64 MB 
32 MB windows: 

0000 0000 0x00000000 0 MB 
0000 0010 0x02000000 32 MB 
0000 0100 0x04000000 64 MB 
0000 0110 0x06000000 96 MB 
16 MB windows: 

0000 0000 0x00000000 0 MB 
0000 0001 0x01000000 16 MB 
0000 0010 0x02000000 32 MB 
0000 0011 0x03000000 48 MB 
0000 0100 0x04000000 64 MB 
0000 0101 0x05000000 80 MB 
0000 0110 0x06000000 96 MB 
0000 0111 0x07000000 112 MB 


2.2.2.4 Specifying the A24 Base Address 


You specify the A24 base address using the A24_ Base parameter. The 
following table lists the base address values for windows in the A24 address 
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space. The base address is stored in bits 16 through 23. The table has been 
truncated for the smaller window sizes. 


Base (Bits 23-16) Bus Address (A24_ Base) Bus Offset 
16 MB window: 

0000 0000 0x00000000 0 MB 
8 MB windows: 

0000 0000 0x00000000 0 MB 
1000 0000 0x00800000 16 MB 
4 MB windows: 

0000 0000 0x00000000 0 MB 
0100 0000 0x00400000 4 MB 
1000 0000 0x00800000 8 MB 
1100 0000 0x00C 00000 12 MB 
2 MB windows: 

0000 0000 0x00000000 0 MB 
0010 0000 0x00200000 2 MB 
0100 0000 0x00400000 4 MB 
0110 0000 0x00600000 6 MB 
1000 0000 0x00800000 8 MB 
1010 0000 0x00A00000 10 MB 
1100 0000 0x00C 00000 12 MB 
1110 0000 Ox00E 00000 14 MB 
1 MB windows: 

0000 0000 0x00000000 0 MB 
0001 0000 0x00100000 1 MB 
0010 0000 0x00200000 2 MB 
0011 0000 0x00300000 3 MB 
0100 0000 0x00400000 4 MB 
0101 0000 0x00500000 5 MB 
0110 0000 0x00600000 6 MB 
0111 0000 0x00700000 7 MB 
1000 0000 0x00800000 8 MB 
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Base (Bits 23-16) Bus Address (A24_ Base) Bus Offset 
1001 0000 0x00900000 9 MB 
1010 0000 0x00A 00000 10 MB 
1011 0000 0x00B 00000 11 MB 
1100 0000 0x00C 00000 12 MB 
1101 0000 0x00D00000 13 MB 
1110 0000 Ox00E 00000 14 MB 
1111 0000 Ox0OF 00000 15 MB 
512 KB windows: 

0000 0000 0x00000000 0 KB 
0000 1000 0x00080000 512 KB 
0001 0000 0x00100000 1024 KB 
0001 1000 0x00180000 1536 KB 
0010 0000 0x00200000 2048 KB 
1111 1000 OxO0F 80000 15872 KB 
256 KB windows: 

0000 0000 0x00000000 0 KB 
0000 0100 0x00040000 256 KB 
0000 1000 0x00080000 512 KB 
0000 1100 0x000C 0000 786 KB 
0001 0000 0x00100000 1024 KB 
1111 1100 Ox00F C0000 16128 KB 
128 KB windows: 

0000 0000 0x00000000 0 KB 
0000 0010 0x00020000 128 KB 
0000 0100 0x00040000 256 KB 
0000 0110 0x00060000 384 KB 
0000 1000 0x00080000 512 KB 
1111 1110 OxOOF E 0000 16256 KB 
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Base (Bits 23-16) Bus Address (A24_Base) Bus Offset 
64 KB windows: 


0000 0000 0x00000000 0 KB 
0000 0001 0x00010000 64 KB 
0000 0010 0x00020000 128 KB 
0000 0011 0x00030000 192 KB 
0000 0100 0x00040000 256 KB 
1111 1111 OxOOF F 0000 16320 KB 


2.2.3 Configuring the VMEbus A16 Address Space 


As part of configuring the vba_vipvic kernel subsystem, you can configure 
the VMEbus 16-bit address space (A16) for your system. A16 space is used 
for interprocessor communication and to communicate with A16 VMEbus 
devices. 


The A16 space has a maximum size of 64 KB and runs from VME bus 
address 0000 hexadecimal to FF FF hexadecimal. You can configure the 
VMEbus Interprocessor Communication Facilities (CF) of the AXPvme 
SBC, Alpha VME 4/nnn or 5/nnn SBC, or Alpha VME 2100 system on any 
256-byte boundary within the VMEbus A16 address space. The default base 
address (parameter A16_ Base) iS Ox00000100. The mask value (parameter 
A16_ Mask) must be left at zero (0x00000000). 


2.2.4 Configuring VMEbus Interrupts 


This section addresses VMEbus interrupt request levels and how to 
configure VME bus interrupts in the software. 


2.2.4.1. VMEbus Interrupt Request Levels 


Table 2-3 lists the system priority levels (SPLs) at which VMEbus and 
VMEbus adapter interrupt requests are delivered to the operating system 
and device drivers. You can query your system’s VMEbus SPLs at run time 
by issuing the command sysconfig -q vba_vipvic. 
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Table 2-3: VIP/VIC VMEbus Interrupt Request Levels 


Interrupt Request Name AXPvme SBC 


Alpha VME SBC 


Alpha VME 2100 


SPLs SPLs SPLs 
VMEbus IRQ 1 SPLDEVLOW SPLDEVLOW SPLDEVLOW 
VMEbus IRQ 2 SPLDEVLOW SPLDEVLOW SPLDEVLOW 
VMEbus IRQ 3 SPLDEVLOW SPLDEVLOW SPLDEVLOW 
VMEbus IRQ 4 SPLDEVHIGH SPLDEVHIGH SPLDEVLOW 
VMEbus IRQ 5 SPLDEVHIGH SPLDEVHIGH SPLDEVLOW 
VMEbus IRQ 6 SPLDEVHIGH SPLDEVHIGH SPLDEVLOW 
VMEbus IRQ 7 SPLDEVRT SPLDEVRT SPLDEVLOW 
Autovector IRQ 1 SPLDEVLOW 
Autovector IRQ 2 SPLDEVLOW 
Autovector IRQ 3 SPLDEVLOW 
Autovector IRQ 4 SPLDEVHIGH 
Autovector |RQ 5 SPLDEVHIGH 
Autovector IRQ 6 SPLDEVHIGH 
Autovector IRQ 7 SPLDEVRT 
VMEbus Reset SPLDEVRT SPLDEVRT 
Module Switches SPLDEVRT SPLDEVRT SPLDEVLOW 
VMEbus IACK SPLDEVLOW SPLDEVLOW SPLDEVLOW 
DMA Status SPLDEVRT SPLDEVRT SPLDEVLOW 


The Alpha VME 4/nnn and 5/nnn SBCs do not support autovector requests. 
The Alpha VME 2100 system does not support autovector or VME bus reset 
interrupt requests. 


As Table 2-3 indicates, AXPvme and Alpha VME SBCs generate interrupt 
requests that higher-level interrupt requests can preempt, while Alpha VME 
2100 interrupt requests are all delivered at the same SPL and cannot be 
preempted. 


On the AXPvme and Alpha VME SBCs, device drivers must use the 
rt_post_callout routine for interrupts delivered at SPLDEVRT. 
Interrupt requests for which this is needed are VMEbus |RQ7, Autovector 
IRQ7, and any of the four module switch interrupts. Device drivers written 
for the SBCs that use the rt_post_callout routine will also run on the 
Alpha VME 2100 system without modifications. 
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Note 


VMEbus device drivers written for Alpha VME 2100 systems, 
or for other platforms that deliver VMEbus interrupts at a 
single SPL, may be affected when run on the AXPvme or Alpha 
VME SBC platforms. If these device drivers are using SPLs to 
protect common resources between thread and interrupt service 
interfaces, the preempted interrupts of the SBC systems may 
have unwanted effects on the drivers. If these device drivers 
are servicing interrupts for VMEbus |RQ7, Autovector |RQ7, or 
module switch interrupts, then the drivers must be modified to 
usethe rt post callout routine Device drivers cannot invoke 
normal thread wakeup mechanisms at SPLDEVRT. 


2.2.4.2 Setting VMEbus Interrupt Vector Parameters 


You specify vectors and interrupt requests (IRQs) for a device driver using 
the Vector and Bus Priority fields of a VBA_Option entry in the 
/etc/sysconfigtab file or ina sysconfigtab file fragment. 


Device drivers are passed this information in the controller structure 
elements ivnum and bus _ priority. 


VMEbus interrupt vectors 24 to 255 are available to device drivers. Vectors 
0 to 23 are reserved by the VME bus adapter. When you specify a vector to 
the vector field of VBA_Option, you must alsousetheBus Priority field 
to specify an IRQ. Valid IRQ specifications are values 1 through 7. These 
values correspond to VME bus levels IRQ1 through IRQ7. 


Note that if a VMEbus device uses an IRQ, that same IRQ cannot be used 
for autovectored interrupts. 


See the Autoconfiguration Support section of Writing VMEbus Device Drivers 
(available in the Device Driver Kit) for an example of adding and enabling 
VMEbus interrupts. See the vme_handler_info structure in Writing 
VMEbus Device Drivers for interrupt handler information. 


2.2.4.3 Specifying Autovector Interrupt Vectors 


The Alpha VME 4/nnn, 5/nnn, and 2100 platforms do not support 
autovectors. 


VMEbus devices of the type Release of Register Access (RORA) use 
autovectors. RORA devices are incapable of presenting a status/l D vector in 
the manner of Release On Acknowledge (ROAK) VMEbus devices. 


RORA devices present an interrupt request to the system at a specified 
VMEbus IRQ level. Upon receipt of the interrupt request, the system 
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provides a system-defined status/ID vector and dispatches it to the interrupt 
service interface installed for the autovector. The device driver is responsible 
for dismissing the RORA device's interrupt request by performing a read or 
write access tothe device. See the hardware manual for the RORA device to 
determine what type of access is needed to dismiss the interrupt request. 


To select an autovector, use the Vector and Bus _ Priority fields of 
VBA_Option. Specify a vector value of 0 (zero) and an IRQ value of 1 
through 7, corresponding to VMEbus levels 1RQ1 through |RQ7. 


If an IRQ is used for an autovector, the same!RQ cannot be used for 
VMEbus interrupt vectors. 


2.2.4.4 Specifying Module Switch Interrupt Vectors 


Specify one of the following vectors in the vector field of VBA_Option to 
select the module switch interrupt you want. Usethe Bus Priority field 
to specify 7 as the IRQ level. 


Module switch 0 Vector 0x1140 [A16 offset 0x21] 
Module switch 1 Vector 0x1150 [A16 offset 0x23] (default) 
Module switch 2. Vector 0x1160 [A16 offset 0x25] 
Module switch 3. Vector 0x1170 [A16 offset 0x27] 


Module switch interrupt vectors allow a module to issue an interrupt to 
itself or to another module. The autoconfiguration software provides control 
and status registers (CSRs) for use in module switch interrupts. You can 
specify two CSRs in a VBA_Option entry in the /etc/sysconfigtab file 
or in a sysconfigtab file fragment. At boot time, the system searches 
for the specified CSRs. 


The autoconfiguration software performs the appropriate bus mapping and 
provides io handle _t values in the addr and addr2 members of the 
driver’s controller structure. The addr argument is passed to the driver’s 
probe routine, while the addr2 value must be obtained from the addr2 
member of the controller structure. 


For example, the following VBA_Option entry specifies a CSR for the base 
address of the A16 I nterprocessor Communication Facilities (ICF). The 
module switch 1 CSR is an offset from this A16 address. 


VBA_Option = Csrl - 0x100, ..., Vector - 0x1150, Bus Priority - 7, ... 


The driver structure allows you to specify the size, address type, and 
swap mode for the CSRs. For example, the following members in a driver 
structure indicate that the first CSR has a size of 256 bytes, is in the A16 
address space, and is set to noswap mode: 
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int addrl_size 256 
int addrl_atype VME_A16_SUPER_ACC | VME_BS NOSWAP 


For more information, see the Device Driver Kit manuals Writing Device 
Drivers and Writing VMEbus Device Drivers, especially the sections on 
the addr and addr2 members of the controller structure and on the 
addrl_size,addrl_atype, addr2_size, and addr2_at ype members of 
the driver structure. 


In addition, you can use the vba_map_csr routine to provide module switch 
interrupts. After using the vba_map_csr routine to create an I/O handle, 
you write to an address derived from the base address plus an offset. Two 
write operations are performed, one signifying a clear and onea set. The 
following code fragment shows how the!/O handle is created: 

io_handle t ioh; /* Define type of ioh */ 

vme_addr_t Alé6base=0x100; /* Base CSR address */ 

ioh = vba_map_csr(ctlr, Alébase, 256, 


(VME_A16 SUPER ACC | 
VME_BS_NOSWAP) ) ; 


The following code fragment shows how the module switch interrupts are 
issued: 
write_io port (ioh+0x22, 1, 0, 0) /* Write to Al6 base address 
plus the offset to clear 
module switch 1 */ 
mb () ; 
write_io port (ioh+0x23, 1, 0, 0) /* Write to Al6é base address 
plus the offset to set 
module switch 1 */ 
mb () ; 


2.2.4.5 Specifying Global Switch Interrupt Vectors 


Global switch interrupts are not currently supported. 


2.2.5 Using VMEbus Hardware Byte-Swapping Modes 


Alpha processors are little endian, while the VMEbus is big endian. The 
default byte-swapping mode, VME_BS NOSWAP, causes the transfer of 
bytes between Alpha processors and the VM Ebus to be arranged correctly. 
If, however, a 16-bit or 32-bit number is needed in a VMEbus register, the 
VME_BS_NOSWAP mode rearranges the bytes within the transfer such 
that the bytes are reversed in significance. Two other modes are provided 
to handle these situations: VME_BS_ BYTE and VME_BS_LWORD.A 
third mode for swapping words within longwords, VME_BS WORD, is not 
portable across VMEbus adapters and is provided for convenience. The 
definitions for these modes are in the ico/dec/vme/vbareg.h file. The 
flags for these modes are used in vba_map_csr, in dma_map_alloc or 
dma_map_load, and in the driver structure. 
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VME_BS_NOSWAP mode provides a hardware mechanism for data 
coherency for byte-data transfers from Alpha processors (little endian) to the 
VMEbus (big endian). The address of any byte as seen on the two buses 
remains the same. Block transfers of byte information use 16- or 32-bit 
transfers. The transfer sizes are 8-, 16-, or 32-bits of byte information. 
Noswap-mode byte addressing is as follows: 


Byte Address 0 1 2 3 

Little Endian | A B Cc D 

Big Endian A B Cc D | 
ZK-1560U-Al 


VME_BS_BYTE mode provides a hardware mechanism for data coherency 
for 16-bit data transfers across the VMEbus, such as loading a 16-bit 
counter on a VMEbus device. In this mode, bytes within words are swapped. 
For portability, use only 16-bit aligned transfers. Byte swap-mode byte 
addressing is as follows: 


Byte Address 0 1 2 3 

Little Endian | A B Cc D 

Big Endian B A D Cc | 
ZK-1561U-Al 


VME_BS_ WORD mode provides a hardware mechanism for swapping words 
within longwords on certain VMEbus adapters. This mode is not portable 
across VMEbus adapters; on other VMEbus adapters, byte swapping may 
be dependent on data size. For AXPvme and Alpha VME platforms, system 
word swap-mode byte addressing is as follows: 


Byte Address 0 1 2 3 

Little Endian | A B Cc D 

Big Endian Cc D A B | 
ZK-1562U-Al 


VME_BS_LWORD mode provides a hardware mechanism for data coherency 
for 32-bit data transfers across the VMEbus, such as loading a 32-bit 
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VMEbus address register. |n this mode, bytes within words are swapped and 
words within longwords are swapped. The transfer size is 32 bits only. For 
portability, use only 32-bit transfers. Longword swap-mode byte addressing 


is as follows: 

Byte Address 0 1 2 3 

Little Endian | A B Cc D 

Big Endian D Cc B A | 


ZK-1563U-Al 


2.2.6 Sharing Memory Between Big Endian and Little Endian 
Processors 


In ashared memory environment, where packed data structures in common 
memory are shared between an Alpha processor (little endian) and a big 
endian processor, software byte swapping is required to arrange bytes 
properly for 16- or 32-bit quantities (such as 16-bit counter values or 32-bit 
VMEbus address values). 


The following combination is recommended: VME_BS_NOSWAP with 
software byte swapping on nonbyte data for the Alpha processor; and no 
swapping on the big endian processor. 


You could implement software swapping with read/write macros that 
perform the swap with the following code. The purpose here is to provide 
code that would run on both little endian and big endian machines that 
have shared memory. 


define read_word/long(iohandle, data) / 
data = read_io port (iohandle, sizeof (word/long) ,0) ;/ 
ifdef LITTLEENDIAN if 
swap_xx (data) ; / 
else /* BIGENDIAN +/ / 
endif 
define write _word/long(iohandle, data) fi 
ifdef LITTLEENDIAN / 
swap_xx (data) ; / 
else /* BIGENDIAN */ / 
write_io port (iohandle, sizeof (word/long) ,0,data); / 
endif 


2.2.7 Performing VMEbus Slave Block Transfers 


The AXPvme and Alpha VME platforms are configured during adapter 
initialization to accept slave block transfers (SBLTs) with data widths of 
D16, D32, or D64. After the SBC has mapped its memory onto the VMEbus 
by using the dma_map_alloc and dma_map_1load routines, no other user 
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interaction is needed. For information on calling the dma_map_ alloc and 
dma_map_load routines, see the corresponding reference pages in the 
Device Driver Kit (available separately from the base operating system). 


Memory must be mapped to the VME bus prior to D64 slave access. 


Access to memory must coincide with the appropriate access mode. If 
you specify supervisory-mode access when memory is mapped, memory 
accesses must use supervisory mode. If you specify user-mode access, both 
supervisory and user access are allowed. 


2.2.8 Performing VMEbus Master Block Transfers with Local DMA 


The VMEbus interfaces for the AXPvme and Alpha VME platforms provide 
a block-mode DMA engine. This DMA engine is capable of transferring up 
to 64 KB of data without processor intervention, in VMEbus data widths 
of D16, D32, or D64. 


The DMA engine transfers data from the VMEbus to system memory (read) 
or from system memory to the VME bus (write). The hardware interface 
handles the segmentation of the transfer. This ensures that the VMEbus 
specification is not violated in relation to crossing VME bus 256-byte 
boundaries for D16 and D32 or 2-K B boundaries for D64. 


The DMA engine is configured to give up the VME bus during the transfer 
and to rearbitrate for the VMEbus again to continue the DMA. Thetime 
between when the DMA engine gives up the bus and rearbitrates for the bus 
is called the interleave period. During the interleave period, single-cycle 
VME bus cycles, receipt of slave block transfers (SBLTs), or other operations 
may be performed. 


The master block transfer (MBLT) hardware interface presents address 
modifiers of user block or supervisory block to the VMEbus, based on 
parameters passed in the software programming interface. The device or 
system on the VME bus must be able to interpret these address modifiers; 
otherwise, bus errors may occur. 


You can use the MBLT hardware interface to: 


¢ Transfer data to and from those VME bus devices that do not have their 
own DMA engine 


« Move data between VMEbus device memory and system memory 


¢ Transfer data to and from other systems that have their memory mapped 
to the VMEbus 


The MBLT hardware interface supports DMA block-mode transfers to and 
from VMEbus A24 and A32 address space only. 
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2.2.8.1. Routines for Master Block-Mode Transfers 


To use master block transfers (MBLTs) with the local hardware DMA engine, 
you must invoke the following routines and supply specific flag values: 


vba_set_dma_addr 
dma_map_alloc 
dma_map_load 
vba_dma 
dma_map_unload 
dma_map_dealloc 


For information on calling these routines, see the corresponding reference 
pages in the Device Driver Kit (available separately from the base operating 
system). 


The flag values DMA_IN and DMA_OUT have specific meaning for VMEbus 
support with respect tothe dma_map_alloc, dma_map_load, and vba_dma 
routines. These flags indicate to the low-level VMEbus dma_map_ alloc, 
dma_map_load, and vba_dma routines that the MBLT hardware DMA 
engine is to be used and the direction of the transfer. 


Specifying DMA_IN implies a read from the VMEbus to system memory. 
Specifying DMA_OUT implies a write from system memory to the VME bus. 
You use the vba_set_dma_addr routine to pass the flag values and the 
VMEbus address at which the transfer is to occur. 


The VME bus block-mode DMA engine on the VMEbus adapter is a single 
entity that must be shared among various device drivers. Specifying 
DMA_SLEEP causes the device driver to block in the vba_dma routine if the 
DMA engine is already being used. If DMA_SLEEP is not specified and the 
DMA engine is being used, vba_dma returns an error. 


The following sample code shows how to invoke the MBLT hardware DMA 
engine for a block-mode read operation. The code uses a VME bus transfer 
width of D32 to invoke a 256 KB transfer from VMEbus address A24 
0x400000 to system memory. The code also allocates resources to handle 
transfers up to1 MB in size. This allows dma_map_load and vba_dma tobe 
invoked multiple times with varying size buffers. You can change the code to 
perform writes by substituting DMA_OUT for DMA_IN. 


struct controller *ctlr; 


vme_addr_t vme_addr = 0x40000; 

unsigned long max_be = (1024*1024) ; 

unsigned long rtn_bc; 

char *buffer; 

unsigned long buffer_bec = (1024 * 256); 

sglist_t dma_handle = (sglist_t) NULL; 

vme_atype_t flags = (VME_A24 UDATA_D32|DMA_IN|DMA_ SLEEP) ; 
int rtn_flags; 


/* 
* Allocate a buffer (256 KB) to be used for the transfer 
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*/ 
MALLOC (buffer, (char *) ,buffer_bc,M DEVBUF,M WAITOK) ; 
/* 

* Specify a VMEbus address of 0x40000 

* Specify flags 

% A24 address space 

* User mode 

* Select DMA engine for a read (DMA_IN) and 

* wait for DMA engine (DMA SLEEP) 


of 
rtn_flags = (int)vba_set_dma_addr(ctlr,flags,vme_addr) ; 
/* 
* Allocate DMA resources for up to 1 Mbyte transfer 
* Specify flags returned from vba_set_dma_addr() above 
me The return value from dma_map_alloc() should equal max_be 
*/ 
rtn_bc = dma_map_alloc(max_bc,ctlr,&dma_handle,rtn_flags) ; 
/* 


* Call dma_map_load() to load the resources for the 


* DMA block-mode engine 

* Specify the dma_handle returned from dma_map_alloc() 
Specify flags returned from vba_set_dma_addr() 

* The return value from dma_map_load() should equal buffer_be 
*/: 


rtn_bc = dma_map_load(buffer_bc, 
(vm_offset_t) buffer, 
0, 
ctlr, 
&dma_handle, 
0, 
rtn_flags) ; 


* Call vba_dma() to start up and monitor the VME adapter’s block-mode 
m DMA engine. Specify the dma_handle returned from dma_map_alloc. 

* The return value from vba_dma() is the actual bytes transferred. 
sl This value should be the same as value buffer_bc. If not, then 

* an error was detected during the transfer. 


*/ 
rtn_be = vba_dma(ctlr,dma_handle) ; 
/* 
* Unload and free DMA resources 
¥/ 


dma_map_unload(0,dma_handle) 
dma_map_dealloc (dma_handle) 


2.2.8.2 Restrictions on VMEbus Master Block Transfers 


The following restrictions apply to using master block transfers (MBLTs) 

on the Alpha VME and AXPvme platforms. Failure to adhere to these 
restrictions may result in data loss during DMA transfers. These restrictions 
are listed by DMA transfer data width. 


¢ D16, D32, and D64 restrictions 


The VMEbus address and the memory address must be |ongword aligned 
(quadword aligned for D64), and the lowest 8 address bits [7:0] must 
match exactly. 


The requested byte count must bein multiples of the data size (multiples 
of 2, 4, and 8 for D16, D32, and D64, respectively). 
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e Further D64 restrictions 


If the VMEbus address is aligned on a 2 KB boundary, the memory 
address must also be aligned on a 2 KB boundary. This restriction will be 
removed in a future release of the operating system. 


Note that you can use the valloc function to allocate memory aligned toa 
page boundary, as described in the valloc(3) reference page. 


For the best DMA performance, the VMEbus address and the memory 
address should be aligned to a 256-byte boundary for D16 and D32 DMA 
transfers, or toa 2048-byte boundary for D64 DMA transfers. 


The Alpha VME 2100 system in an SMP environment emulates DMA 
transfers using PIO operations instead of using an MBLT hardware DMA 
engine. The VMEbus adapter on this system requires three |/O accesses 

to be atomic to start the DMA engine. These l/O operations cannot be 
guaranteed to be atomic in an SMP environment. Uniprocessor systems use 
the MBLT hardware DMA engine. 


2.2.9 Using the Realtime Interrupt-Handling Routine rt_post_callout 


Interrupt service interfaces (ISIs) executing at SPLDEVRT (SPL 6) must 
not call kernel routines directly. Thert post callout routine allows the 
calling process to defer execution of a function until a time when kernel 
routines can be invoked. The function invoked by rt_post_callout runs 
at an elevated SPL and is subject to the same restrictions as an ISI. 


The syntax for the function invoked by rt_post_callout is as follows: 
int (*function) (), 


long argl, 
long arg2 ); 


The parameters for the rt_ post callout routine areas follows: 


function Name of the function to be invoked 
argl The first argument passed to the function 
arg2 The second argument passed to the function 


If rt_post_callout is called again with the same function and arguments 
specified, then the duplicate invocation is dismissed before the first 
invocation has executed. 


The following example is for an interrupt service interface (ISI) that runs 
at SPLDEVRT: 


rt_dev_intr (unit) 
int unit; 


register struct rt_softc *sc = rt_softc[unit]; 
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rt_post_callout (user_wakeup_interface, /* User wakeup function */ 
(long) &sc->error_recovery flag, /* Event to wake*/ 
(long) NULL) ; /* Unused argument */ 
return; 


} 


The following example shows a user-written function to wake up an event 
called by the rt_post_callout routine: 

void user_wakeup_interface ( argl, arg2 ) 

long arg1l; 

long arg2; 


thread_wakeup( (vm_offset_t) argl)j; 


} 


2.3 Configuring UNIVERSE II-Based Alpha VME SBCs 


This section describes how to set up UNIVERSE II-based Alpha VME 
systems for use on the VME bus, including how to modify attributes of the 
vba_univ kernel subsystem. 


VMEbus UNIVERSE II setup allows you to run the operating system on 
UNIVERSE I|-based Alpha VME systems. For information about installing 
the operating system on these systems, see the Installation Guide 


For information about setting up VIP/VIC-based Alpha VME systems for 
use on the VME bus, see Section 2.2. 


This section addresses the following topics relating to the use of the VME bus 
on UNIVERSE II-based Alpha VME systems: 


¢ Configuring the vba_univ subsystem (Section 2.3.1) 

¢ Configuring PCI-to-VME address spaces (Section 2.3.2) 

¢ Configuring a special A24/A16 PCl-to-VME window (Section 2.3.3) 
¢ Configuring VME-to-PCl address spaces (Section 2.3.4) 

¢ Mapping UNIVERSE II CSRs tothe VMEbus (Section 2.3.5) 

¢ Mapping a location monitor window to the VME bus (Section 2.3.6) 
¢ Configuring VMEbus interrupts (Section 2.3.7) 

e« Using VMEbus software byte swapping (Section 2.3.8) 


e« Sharing memory between big endian and little endian processors 
(Section 2.3.9) 


¢ Performing VMEbus slave block transfers (Section 2.3.10) 


¢ Performing VMEbus master block transfers with local DMA 
(Section 2.3.11) 
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e Using the realtime interrupt-handling routine rt_ post callout 
(Section 2.3.12) 


2.3.1 Configuring the vba_univ Subsystem 


This section describes how to configure the vba_univ kernel subsystem in 
order to prepare UNIVERSE I|-based Alpha VME systems for use on the 
VMEbus. 


You configure the UNIVERSE II adapter by examining the default (or 
current) attributes supplied for the vba_univ subsystem, determining 
which attributes (if any) you want to change, then modifying 

the /etc/sysconfigtab file on your machine. After modifying 
/etc/sysconfigtab, you must shut down and reboot the system. 


Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain private 
sysconfigtab file fragments for vba_univ attributes and use 
sysconfigdb switches toadd (-a -f), delete (-d), or merge 
(-m -£) vba_univ attribute values. The example in Section 3.7 
illustrates this approach. The sys_attrs(5) reference page 
provides additional guidelines for editing kernel subsystem 
attributes. You must always reboot after changing vba_univ 
subsystem attributes. 


You can modify values for the following UNIVERSE II adapter attributes; 
each list item corresponds to a later subsection: 


Adapter interrupt dispatch policy (Section 2.3.1.1) 
Adapter PCI scatter/gather maximum size (Section 2.3.1.2) 
Adapter DMA window maximum size (Section 2.3.1.3) 

PCI coupled window timer value (Section 2.3.1.4) 

PCI maximum retries (Section 2.3.1.5) 

PCI posted write transfer count (Section 2.3.1.6) 

PCI aligned burst size (Section 2.3.1.7) 

VMEbus request level (Section 2.3.1.8) 

VMEbus request mode (Section 2.3.1.9) 

VMEbus release mode (Section 2.3.1.10) 

VMEbus timeout period (Section 2.3.1.11) 

VMEbus arbitration mode (Section 2.3.1.12) 

VMEbus arbitration timeout period (Section 2.3.1.13) 
System controller VMEbus resets (Section 2.3.1.14 and Section 2.3.1.15) 
VMEbus on and off counters for MBLTs (Section 2.3.1.16) 
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You can also configure VMEbus windows in the following ways; each list 
item corresponds to a later subsection: 


Configuring PCl-to-VME address spaces (Section 2.3.2) 
Configuring a special A24/A16 PCI-to-VME window (Section 2.3.3) 
Configuring VME-to-PCI address spaces (Section 2.3.4) 

Mapping UNIVERSE II CSRs tothe VMEbus (Section 2.3.5) 
Mapping a location monitor window to the VMEbus (Section 2.3.6) 


Table 2-4 lists the defaults supplied for various VMEbus parameters. The 
default values specified should provide proper VMEbus operation for most 
applications. Be careful when modifying these values; not all adapters 


support all fields. 


Table 2-4: UNIVERSE II VMEbus Adapter Defaults 


Parameter 


Default 


Meaning 


VBA_ISR_Dispatch Policy 1 


VBA _Max_PCI_ Sg Size 


VBA_Max DMA Wndw_ Size 


PCI Coupled Wndw_Tmr 


PCI Max Retry 


PCI Posted Wrt On Cnt 


PCI Aligned Burst _ Size 
VME_Br_ Lev 


VME_ Fair Reg 


VME_Rel_ Mode 


VME_Bus_To 


VME_Arb Mode 


VME_Arb_To 
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0x20000000 


0x4000000 


Ox2 


OxF 


0x0 


0x1 
0x3 
0x1 


Ox1 


Ox6 


0x0 
0x1 


Adapter interruupt dispatch policy 
is to process all interrupts for 
the current SPL (only) 


Maximum PCI scatter/gather 
size is 512 MB 


Maximum DMA window size 
is 64 MB 


Coupled Window Timer set to hold 
VMEbus for 32 PCI clock cycles 
after a coupled transaction 


PCI maximum retries before 
signaling error set to 960 (value*64) 


PCI posted write transfer count 
is 128 bytes 


PCI aligned burst size is 64 bytes 
Bus request level 3 for master cycles 


VMEbus request mode is fair 
(not demand) 


Release mode is release on 
request (ROR) 


VMEbus timeout period is 512 
microseconds 


Arbitration mode is round robin 


VMEbus arbitration timeout period 
is 16 microseconds 


Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 
VME_Syscon Ox1 System controller VMEbus 
reset is enabled 
VME_Von_D64 Ox4 VMEbus On counter for D64 MBLT: 
hold bus tenure for 2048 bytes 
VME_Voff Dé6é4 0x9 VMEbus Off counter for D64 MBLT: 
DMA interleave is 4 microseconds 
VME_Von_D32 Ox2 VMEbus On counter for D32 MBLT: 
hold bus tenure for 512 bytes 
VME_Voff_D32 0x9 VMEbus Off counter for D32 MBLT: 


DMA interleave is 4 microseconds 


For the special A24/A16 PCI-to-VME (PCI slave) window: 


VME_A24 Al6é Wnd_Ena 1 Special A24/A16 PCI-to-VME 
window (64 MB) is enabled 

VME_A24 Al6 Wnd WP Ena 1 Write posting enabled to the 
A24/A16 window 

VME_A24_A16_Wnd_Dwdth OxF A24/A16 window maximum data 
width is D32 (all quadrants) 

PCI_SLSI_Base 0 Stores A24/A16 (64 MB) window base 


address (obtained from firmware) 


VME_A24 Size OxF F 0000 Stores the size of each A24 address 
space within the A24/A16 window; 
obtainable via sysconfig -q, 
default is 16MB-64KB 


VME_A16 Size 0x10000 Stores the size of each A16 address 
space within the A24/A16 window; 
obtainable via sysconfig -q, 
default is 64KB 


For PCI-to-VME (PCI slave) windows 0 through 7: 


PCI_LSI_Base 0 Stores base address of the contiguous 
PCI dense space available for 
PCl-to-VME windows (obtained 
from firmware) 


PCI Mem Avail 0 Stores number of bytes allocated by 
firmware for PCI-to-VME windows 

PCI_Mem_Free 0 Stores number of bytes available 
for further PCI-to-VME window 
allocations 

VME_Wnd0o_Ena 1 Window 0 is enabled: 


VME _Wnd0 VME Address 0x80000000 VMEbus base address is 0x80000000 
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Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 

VME_Wnd0o_ Size 0x08000000_ Size is 128 MB 

VME_Wnd0 AM Space 2 A32 space 
VME_Wnd0 AM Usr Sprvsr 1 User mode 

VME Wnd0O AM Data Prg 1 Data access 
VME_Wndo_Dwdth 2 Maximum data width is D32 
VME_Wnd0O_WP_Ena 1 Write posting is enabled 
VME _Wndo Cycle Sel 0 VMEbus single cycles only 
VME_Wnd1_Ena 1 Window 1 is enabled: 

VME _Wndl_ VME Address 0x80000000 VMEbus base address is 0x80000000 
VME_Wndl1_Size 0x08000000_ Size is 128 MB 

VME _Wndl_ AM Space 2 A32 space 

VME _Wndl_ AM Usr Sprvsr 1 User mode 

VME _Wnd1 AM Data _Prg 2 Program access 
VME_Wnd1_Dwdth 2 Maximum data width is D32 
VME _Wndl_ WP Ena 1 Write posting is enabled 

VME Wndl_ Cycle Sel 0 VMEbus single cycles only 
VME_Wnd2_Ena 1 Window 2 is enabled: 
VME_Wnd2_VME_ Address 0x80000000 VMEbus base address is 0x80000000 
VME_Wnd2_ Size 0x08000000_ Size is 128 MB 

VME_Wnd2_ AM Space 2 A32 space 

VME _Wnd2 AM Usr Sprvsr 2 Supervisory mode 

VME Wnd2 AM Data Prg 1 Data access 
VME_Wnd2_Dwdth 2 Maximum data width is D32 
VME_Wnd2_WP_Ena 1 Write posting is enabled 
VME Wnd2 Cycle Sel 0 VMEbus single cycles only 
VME_Wnd3_Ena 1 Window 3 is enabled: 

VME _Wnd3 VME Address 0x80000000 VMEbus base address is 0x80000000 
VME_Wnd3_ Size 0x08000000_ Size is 128 MB 

VME _Wnd3 AM Space 2 A32 space 
VME_Wnd3 AM Usr Sprvsr 2 Supervisory mode 
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Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 

VME Wnd3 AM Data Prg 2 Program access 
VME_Wnd3_Dwdth 2 Maximum data width is D32 
VME_Wnd3_WP_Ena 1 Write posting is enabled 
VME _Wnd3 Cycle Sel 0 VMEbus single cycles only 
VME_Wnd4_Ena 1 Window 4 is enabled: 
VME_Wnd4_VME_Address Ox0OFFOO00 VMEbus base address is OxF F 0000 
VME_Wnd4_ Size 0x00010000_ Size is 64 KB 

VME _Wnd4 AM Space 1 A24 space 

VME _Wnd4 AM Usr Sprvsr 1 User mode 

VME Wnd4 AM Data Prg 1 Data access 
VME_Wnd4_Dwdth 2 Maximum data width is D32 
VME _Wnd4 WP Ena 1 Write posting is enabled 

VME Wnd4 Cycle Sel 0 VMEbus single cycles only 
VME_Wnd5_Ena 1 Window 5 is enabled: 
VME_Wnd5_VME_Address Ox00FFO000 VMEbus base address is OxF F 0000 
VME_Wnd5 Size 0x00010000_ Size is 64 KB 
VME_Wnd5_AM Space 1 A24 space 
VME_Wnd5 AM Usr Sprvsr 2 Supervisory mode 

VME Wnd5 AM Data Prg 1 Data access 
VME_Wnd5_Dwdth 2 Maximum data width is D32 
VME_Wnd5_WP_Ena 1 Write posting is enabled 
VME Wnd5 Cycle Sel 0 VMEbus single cycles only 
VME_Wnd6_Ena 0 Window 6is disabled by default: 
VME _Wnd6é VME Address 0x0 

VME_Wnd6 Size 0x0 

VME_Wnd6 AM Space 0 A16 space 
VME_Wnd6 AM Usr Sprvsr 1 User mode 

VME Wnd6 AM Data Prg 1 Data access 

VME_Wnd6é_ Dwdth 2 Maximum data width is D32 
VME_Wnd6 WP Ena 1 Write posting is enabled 
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Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 

VME Wnd6é Cycle Sel 0 VMEbus single cycles only 
VME_Wnd7_Ena 0 Window 7 is disabled by default: 
VME_Wnd7_VME Address 0x0 

VME_Wnd7_ Size 0x0 

VME_Wnd7_ AM Space 0 A16 space 

VME _Wnd7_ AM Usr Sprvsr 1 User mode 

VME Wnd7 AM Data Prg 1 Data access 
VME_Wnd7_Dwdth 2 Maximum data width is D32 
VME_Wnd7_ WP Ena 1 Write posting is enabled 

VME _Wnd7 Cycle Sel 0 VMEbus single cycles only 


For VME-to-PCI (VMEbus slave) windows 0 through 7: 


PCI _Wndo_ Ena 


PCI Wnd0O VME Address 
PCI Wndo Size 

PCI Wnd0O AM Space 

PCI WndO AM Usr_ Sprvsr 


PCI Wnd0 AM Data Prg 


PCI Wnd0O WP_Ena 


PCI WndO Pre Rd Ena 


PCI _Wndo_ PCI64 Ena 


PCI WndoO PCI Lock Ena 


PCI _Wndl_ Ena 


PCI Wnd1l_ VME Address 


PCI_ Wndl1_ Size 
PCI Wndl AM Space 
PCI Wndl AM Usr_Sprvsr 


PCI Wndl AM Data Prg 


PCI _Wndl_ WP_Ena 
PCI_Wnd1 Pre Rd_Ena 


PCI Wndl PCI64 Ena 


1 
0x00C 00000 
0x00400000 


1 
3 
3 
1 
1 
i 
0 
1 
0x08000000 


0x08000000 


2 
3 
3 
1 
1 
1 
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Window 0 is enabled: 

VMEbus base address is OxCQ0000 
Size is 4 MB 

A24 space 

Both user and supervisory mode 
Both data and program access 
Write posting is enabled 

Prefetch reads are enabled 

PCI 64 transactions are enabled 
Lock is disabled (not modifiable) 
Window 1 is enabled: 

VMEbus base address is 0x8000000 
Size is 128 MB 

A32 space 

Both user and supervisory mode 
Both data and program access 
Write posting is enabled 

Prefetch reads are enabled 


PCI 64 transactions are enabled 


Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 
PCI_Wnd1_PCI_Lock_Ena 0 Lock is disabled (not modifiable) 
PCI Wnd2 Ena 0 Window 2 is disabled by default: 
PCI_Wnd2_ VME Address 0x0 

PCI Wnd2 Size 0x0 

PCI _Wnd2 AM Space 1 A24 space 

PCI_Wnd2_AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI _Wnd2 AM Data _Prg 3 Both data and program access 
PCI _Wnd2 WP Ena 1 Write posting is enabled 

PCI Wnd2 Pre Rd _ Ena 1 Prefetch reads are enabled 

PCI Wnd2 PCI64 Ena 1 PCI 64 transactions are enabled 
PCI Wnd2 PCI _Lock_Ena 0 Lock is disabled (not modifiable) 
PCI _Wnd3_ Ena 0 Window 3 is disabled by default: 
PCI _Wnd3 VME Address 0x0 

PCI Wnd3 Size 0x0 

PCI _Wnd3 AM Space 1 A24 space 

PCI _Wnd3 AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI Wnd3_AM Data_Prg 3 Both data and program access 
PCI Wnd3 WP Ena 1 Write posting is enabled 
PCI_Wnd3 Pre Rd Ena 1 Prefetch reads are enabled 
PCI_Wnd3 PCI64 Ena 1 PCI 64 transactions are enabled 
PCI_Wnd3_PCI_Lock_Ena 0 Lock is disabled (not modifiable) 
PCI Wnd4 Ena 0 Window 4 is disabled by default: 
PCI _Wnd4 VME Address 0x0 

PCI Wnd4 Size 0x0 

PCI_Wnd4 AM Space 1 A24 space 

PCI_Wnd4 AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI Wnd4 AM Data Prg 3 Both data and program access 
PCI_Wnd4 WP Ena 1 Write posting is enabled 

PCI Wnd4 Pre Rd _ Ena 1 Prefetch reads are enabled 

PCI Wnd4 PCI64 Ena 1 PCI 64 transactions are enabled 
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Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 


Parameter Default Meaning 
PCI_Wnd4_PCI_Lock_Ena 0 Lock is disabled (not modifiable) 
PCI Wnd5 Ena 0 Window 5 is disabled by default: 
PCI_Wnd5 VME Address 0x0 

PCI Wnd5 Size 0x0 

PCI _Wnd5 AM Space 1 A24 space 

PCI_Wnd5_AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI Wnd5 AM Data_Prg 3 Both data and program access 
PCI Wnd5 WP Ena 1 Write posting is enabled 

PCI Wnd5 Pre Rd _ Ena 1 Prefetch reads are enabled 

PCI Wnd5 PCI64 Ena 1 PCI 64 transactions are enabled 
PCI Wnd5 PCI Lock _Ena 0 Lock is disabled (not modifiable) 
PCI _Wnd6é Ena 0 Window 6 is disabled by default: 
PCI Wnd6 VME Address 0x0 

PCI _Wnd6é Size 0x0 

PCI _Wnd6é AM Space 1 A24 space 

PCI Wnd6é AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI Wnd6é_AM Data_Prg 3 Both data and program access 
PCI Wnd6é WP Ena 1 Write posting is enabled 

PCI _Wnd6é Pre Rd Ena 1 Prefetch reads are enabled 

PCI Wnd6é PCI64 Ena 1 PCI 64 transactions are enabled 
PCI_Wnd6_PCI_Lock_Ena 0 Lock is disabled (not modifiable) 
PCI _Wnd7_ Ena 0 Window 7 is disabled by default: 
PCI_Wnd7_ VME Address 0x0 

PCI Wnd7 Size 0x0 

PCI _Wnd7_AM Space 1 A24 space 

PCI_Wnd7_AM Usr_Sprvsr 3 Both user and supervisory mode 
PCI Wnd7_ AM Data Prg 3 Both data and program access 
PCI_Wnd7_ WP Ena 1 Write posting is enabled 

PCI _Wnd7 Pre Rd _ Ena 1 Prefetch reads are enabled 

PCI Wnd7_ PCI64 Ena 1 PCI 64 transactions are enabled 
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Table 2-4: UNIVERSE II VMEbus Adapter Defaults (cont.) 
Parameter Default Meaning 


PCI Wnd7_ PCI Lock Ena 0 Lock is disabled (not modifiable) 


For UNIVERSE II CSR and location monitor window mapping: 


CSR_Ena 1 UNIVERSE II CSR mapping 
is enabled: 
CSR_VME_Address OxFFFFO000 VMEbus base address is 
OxF F FF 0000 
CSR_AM Space 2 A32 space 
CSR_AM Usr_Sprvsr 2 Supervisory mode 
CSR_AM Data Prg 3 Both program and data access 
| Ena 0 Location monitor mapping is 
disabled by default: 
LM_VME_ Address OxFFFF1000 VMEbus base address is 
OxF F FF 1000 
LM AM Space 2 A32 space 
LM AM Usr_Sprvsr 2 Supervisory mode 
LM_AM_Data_Prg 3 Both program and data access 


Table 2-5 lists VMEbus interrupt parameters and their initial defaults. 
These defaults are later overwritten by system priority level (SPL) values 
supplied by the platform. See the SPL values listed in Table 2-6, or query 
the values at run time using the command sysconfig -q vba_univ. 


Table 2-5: UNIVERSE II VMEbus Interrupt Initial Defaults 
Parameter Default Meaning 


Irq0_ SPL VMEbus IRQ level to system SPL map 
VMEbus IRQ 1 to SPL SPLDEVHIGH 
VMEbus IRQ 2 to SPL SPLDEVHIGH 
VMEbus IRQ 3 to SPL SPLDEVHIGH 


4 
Irql_ SPL 4 
4 
4 
Irq4 SPL 4 VMEbus IRQ 4to SPL SPLDEVHIGH 
4 
4 
4 
4 


Irq2_ SPL 
Irq3_SPL 
Irq5_SPL VMEbus IRQ 5 to SPL SPLDEVHIGH 
VMEbus IRQ 6 to SPL SPLDEVHIGH 
VMEbus IRQ 7 to SPL SPLDEVHIGH 
Adapter resource blocking SPL SPLDEVHIGH 


Irq6_SPL 


Irq7_ SPL 


Adapt _Blk SPL 


Configuring the VMEbus for Aloha VME Systems 2-37 


2.3.1.1 Specifying the Adapter Interrupt Dispatch Policy 


You can specify one of the following values for the adapter interrupt dispatch 
policy (parameter VBA_ISR_ Dispatch Policy): 


i Process all interrupts for the current SPL (default) 


2 Process all interrupts for the current SPL, then check for 
and process additional interrupts once 


2.3.1.2 Specifying the Adapter PCI Scatter/Gather Maximum Size 


You can specify a multiple of 64 KB (0x10000) up to 512 MB (0x20000000) 
for the adapter PCI scatter/gather maximum size (parameter 
VBA_Max_PCI_Sg_Size). Thedefault is 512 MB. 


If the combined amount of scatter/gather resources needed to map all 
enabled VME-to-PCl windows exceeds the value of VBA_Max_ PCI Sg Size, 
the adapter will not be configured. You can usethe VBA_Max PCI Sg Size 
parameter to constrain the consumption of PCI scatter/gather resources. 


2.3.1.3 Specifying the Adapter DMA Window Maximum Size 


You can specify one of the following values for the adapter DMA window 
maximum size (parameter VBA Max DMA Wndw Size). This value 
determines the amount of scatter/gather resources allocated for the DMA 
engine during adapter initialization. If the amount of scatter/gather 
resources needed for a requested DMA transfer exceeds the value of 
VBA_Max DMA Wndw Size, the DMA transfer will be broken up into 
segments and the scatter/gathers will be reloaded for each segment. 


You can use the VBA Max DMA Wndw_ Size parameter to constrain the 
consumption of DMA scatter/gather resources or to throttle DMA transfers 
(reducing granularity to force reloads). 


This software resource constraint is independent of the adapter’s hardware 
constraint on transfer size (up to 16 MB minus 2 KB of data without 
processor intervention). 


0x2000 8 KB 
0x4000 16 KB 
0x8000 32 KB 
0x10000 64 KB 
0x20000 128 KB 
0x40000 256 KB 
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0x80000 512 KB 


0x100000 1 MB 

0x200000 2 MB 

0x400000 4 MB 

0x800000 8 MB 
0x1000000 16 MB 
0x2000000 32 MB 
0x4000000 64 MB (default) 
0x8000000 128 MB 
0x10000000 256 MB 


2.3.1.4 Specifying the PCI Coupled Window Timer Value 


You can specify one of the following values for the PCI coupled window timer 
value (parameter PCI_ Coupled Wndw_ Tmr). This value is stored in the 
PCI Miscellaneous Register (LMISC). 


The Universe Il adapter uses the coupled window timer to determine how 
long to hold ownership of the VME bus on behalf of the PCI Slave Channel 
after processing a coupled transaction. The timer is restarted each time the 
Universe II processes a coupled transaction. If this timer expires, then the 
PCI Slave Channel! releases the VME Master Interface. 


0x0 Disable Coupled Window Timer (CWT) 
0x1 CWT =16 PCI dock cycles 

Ox2 CWT = 32 PCI clock cycles (default) 
0x3 CWT = 64 PCI dock cycles 

Ox4 CWT =128 PCI clock cycles 

Ox5 CWT = 256 PCI clock cycles 

Ox6 CWT =512 PCI clock cycles 


2.3.1.5 Specifying the PCI Maximum Retries 


You can specify one of the following values for the number of PCI maximum 
retries before signaling errors (parameter PCI_ Max Retry). This valueis 
stored in the Master Control Register (MAST_CTL). 


0x0 Retry forever (on PCI) 
Ox1 Retry 64 times 
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0x2 Retry 128 times 


0x3 Retry 192 times 
0x4 Retry 256 times 
0x5 Retry 320 times 
Ox6 Retry 384 times 
Ox7 Retry 448 times 
0x8 Retry 512 times 
0x9 Retry 576 times 
OxA Retry 640 times 
OxB Retry 704 times 
OxC Retry 768 times 
OxD Retry 832 times 
OxE Retry 896 times 
OxF Retry 960 times (default) 


2.3.1.6 Specifying the PCI Posted Write Transfer Count 


You can specify one of the following values for the PCI posted write transfer 
count (parameter PCI_Posted_Wrt_On_Cnt). This value is stored in the 
Master Control Register (MAST CTL). 


0x0 Posted write transfer count = 128 bytes (default) 
Ox1 Posted write transfer count = 256 bytes 

Ox2 Posted write transfer count = 512 bytes 

0x3 Posted write transfer count = 1024 bytes 

Ox4 Posted write transfer count = 2048 bytes 

Ox5 Posted write transfer count = 4096 bytes 


2.3.1.7 Specifying the PCI Aligned Burst Size 


You can specify one of the following values for the PCI aligned burst size 
(parameter PCI_ Aligned Burst Size). This value is stored in the Master 
Control Register (MAST_CTL). 


0x0 PCI aligned burst size = 32 bytes 
Ox1 PCI aligned burst size = 64 bytes (default) 
0x2 PCI aligned burst size = 128 bytes 
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2.3.1.8 Specifying the VMEbus Request Level 


You can specify one of the following values for the VME bus request | evel 
(parameter VME_Br Lev). This value is stored in the Master Control 
Register (MAST_CTL). 


0x0 VMEbus request level BRO 
Ox1 VMEbus request level BR1 
0x2 VMEbus request level BR2 
0x3 VMEbus request level BR3 (default) 


2.3.1.9 Specifying the VMEbus Request Mode 


2.3.1.10 


2.3.1.11 


You can specify one of the following values for the VMEbus request mode 
(parameter VME_Fair_ Req). This value is stored in the Master Control 
Register (MAST CTL). 

Ox0 Request mode is demand 

0x1 Request mode is fair (default) 


Specifying the VMEbus Release Mode 


You can specify one of the following values for the release mode (parameter 
VME_Rel_ Mode). This value is stored in the Master Control Register 
(MAST_CTL). 

0x0 Release when done, RWD 

0x1 Release on request, ROR (default) 


Specifying the VMEbus Timeout Period 


You can specify one of the following values for the VME bus timeout period 
(parameter VME_Bus_ To). This valueis stored in the Miscellaneous Control 
Register (MISC_CTL). 


0x0 Timeouts are disabled 

0x1 Timeout = 16 microseconds 
0x2 Timeout = 32 microseconds 
0x3 Timeout = 64 microseconds 
0x4 Timeout = 128 microseconds 
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2.3.1.12 


2.3.1.13 


2.3.1.14 


Ox5 Timeout = 256 microseconds 


0x6 Timeout = 512 microseconds (default) 


Specifying the VMEbus Arbitration Mode 


You can specify one of the following values for the VME bus arbitration mode 
(parameter VME_Arb Mode). This value is stored in the Miscellaneous 
Control Register (MISC _CTL). This parameter is applicable only when the 
VMEbus adapter is configured to be the system controller. 


0x0 UNIVERSE II performs round-robin VMEbus ar- 
bitration (default) 
Ox1 UNIVERSE II performs priority VMEbus arbitration 


Specifying the VMEbus Arbitration Timeout Period 


You can specify one of the following values for the VMEbus arbitration 
timeout period (parameter VME_Arb To). This value is stored in the 
Miscellaneous Control Register (MISC CTL). 


0x0 Timeouts are disabled 
0x1 Timeout = 16 microseconds (default) 
Ox2 Timeout = 256 microseconds 


Specifying System Coniroller VMEbus Resets 


You can specify one of the following values to indicate whether or not the 
adapter should issue VME bus resets if it is the system controller (parameter 
VME_Syscon). This value is stored in the Miscellaneous Control Register 
(MISC CTL). 


For Alpha VME SBCs, in addition to specifying a value from this list, you 
must set the configuration switches to indicate whether or not the SBC is the 
VMEbus system controller. See the SBC's installation guide for information 
on setting the module configuration switches. 


The VMEbus backplane must have only one system controller. The system 
controller must be electrically the first module in the VME bus backplane 
and in most systems must bein the first VMEbus slot. 

0x0 Do not issue VMEbus resets if system controller 


Ox1 Issue VMEbus resets if system controller (default) 
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2.3.1.15 


The values specified interact with the VMEbus initialization code to 
determine whether a VMEbus reset is issued when the VME bus adapter is 
being configured. If the value is set to 1 and the system being booted is 
the system controller, as determined by the VMEbus initialization code, a 
VME bus reset is issued. If you do not want a VMEbus reset issued during 
VMEbus adapter configuration, set the value to 0 (zero). These values 
pertain only to the system controller. 


If the system controller is configured to issue a VME bus reset during adapter 
initialization, and other processor modules are installed in the VME bus 
backplane, boot the system controller first to allow devices and processor 
modules to perform their bus reset actions. 


Special Considerations for VMEbus Resets 


The system controller should always be the initiator of VMEbus resets. 
However, under certain error conditions, other VMEbus adapter modules 
may invoke a VMEbus reset. Modules installed in the VMEbus backplane 
react to bus resets differently. Some modules, if configured, perform a 
module reset. Some may have their VMEbus interface reset to a power-up 
state without notification to the operating system. This could leave the 
VMEbus adapters in an unconfigured state, cause unwanted effects to 
the operating system and its device drivers, and cause VMEbus errors to 
occur. Other VMEbus adapters on the VMEbus may accept VME bus resets 
and attempt to reconfigure themselves to the hardware context they were 
running before the bus reset occurred. However, device drivers expecting 
interrupts may not receive them and I/O hardware operations may be 
canceled by the VMEbus reset without notification to the device driver. 
There is also a potential for data corruption to occur when the VME bus 
adapter is reset during an I/O operation. 


It is recommended that the system controller be the initiator of VMEbus 
resets during adapter initialization. If the system controller is not controlled 
by a processor, then a power-up sequence should cause all VMEbus adapters 
and devices to be reset. All modules on the VMEbus should perform a 
module reset upon detection of a bus reset. VMEbus adapters that are not 
the system controller and that are running an operating system should be 
shut down in an orderly fashion prior to the system controller being booted. 
These VMEbus adapters should be rebooted after the system controller has 
been booted, providing that the system controller is to be used and controlled 
by a processor. 


For Alpha VME SBCs, it is recommended that nodes that are not the system 
controller have their module configuration switch 3 set to Closed (resets the 
SBC module on VMEbus reset signal). When the VMEbus is reset, and 

the module switch is set to accept a VMEbus reset, nonsystem controller 
modules take a boot action and are reset to a powered state. 
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2.3.1.16 


If the SBC module configuration switch 3 is set to Open (does not reset 

the SBC module on VMEbus reset signal), the VMEbus adapter software 
will receive a VMEbus reset interrupt upon detection of a bus reset. The 
VMEbus reset signal initializes the VMEbus adapter to its power-up state. 
The VMEbus reset interrupt service interface displays the following message 
on the console terminal: 


vbaO reset_inter: VMEbus reset detected 


The interrupt service interface then initializes the VMEbus adapter to its 
defaults and enables any previously enabled interrupt enable bits. 


Do not set the SBC module configuration switch 3 to Open without 
considering the following side effects of receiving a VMEbus reset: device 
drivers expecting interrupts may not receive them and I/O hardware 
operations may be canceled by the VME bus reset without notification to the 
device drivers. There is potential risk of data corruption depending upon I/O 
activity at the time a bus reset occurred. 


Specifying the VMEbus On and Off Counters for MBLTs 


You can specify one of the following values for the VMEbus On Counter for 
D64 MBLTs (parameter VME_Von_D64) or the VMEbus On Counter for D32 
MBLTs (parameter VME_Von_D32). This value is stored in the DMA General 
Control and Status Register (DGCS). 


0x0 All bytes transferred until done 

Ox1 256-byte boundary 

0x2 512-byte boundary (D32 MBLT default) 
0x3 1024-byte boundary 

0x4 2048-byte boundary (D64 MBLT default) 
Ox5 4096-byte boundary 

Ox6 8192-byte boundary 

Ox7 16384-byte boundary 


You can specify one of the following values for the VME bus Off Counter for 
D64 MBLTs (parameter VME_Vof£_Dé64) or the VMEbus Off Counter for 
D32 MBLTs (parameter VME_Voff_D32). This valueis stored in the DMA 
General Control and Status Register (DGCS). 


0x0 0 microseconds between VMEbus tenures 
0x1 16 microseconds between VMEbus tenures 
Ox2 32 microseconds between VMEbus tenures 
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0x3 
0x4 
0x5 
Ox6 
Ox7 
0x8 
0x9 
OxA 


64 microseconds between VMEbus tenures 

128 microseconds between VME bus tenures 

256 microseconds between VME bus tenures 

512 microseconds between VME bus tenures 

1024 microseconds between VME bus tenures 

2 microseconds between VMEbus tenures 

4 microseconds between VMEbus tenures (default) 


8 microseconds between VMEbus tenures 


2.3.2 Configuring PCI-to-VME Address Spaces 


As part of configuring the vba_univ kernel subsystem, you can configure up 
to eight PCI-to-VME (PCI slave) windows, numbered 0 through 7, for your 
system. Additionally, you can map a special 64 MB window for VME bus 
A24 and A16 accesses. 


By default, the following PCl-to-VME windows are provided on your system: 


Window 0 - enabled VMEbus base address 0x80000000, 128 
MB, A32 user data 
Window 1 - enabled VMEbus base address 0x80000000, 128 
MB, A32 user program 
Window 2 - enabled VMEbus base address 0x80000000, 128 MB, 
A32 supervisory data 
Window 3 - enabled VMEbus base address 0x80000000, 128 MB, 
A32 supervisory program 
Window 4 - enabled VMEbus base address OxOOF F 0000, 64 
KB, A24 user data 
Window 5 - enabled VMEbus base address OxOOF F0000, 64 KB, 
A24 supervisory data 
Window 6 - disabled VMEbus base address 0x00000000, 0, A16 user data 
Window 7 - disabled VMEbus base address 0x00000000, 0, A16 user data 


A24/A16 window - enabled 64 MB (four equal quadrants for user data, user 


program, supervisory data, supervisory program), 
top 64 KB per quadrant window is A16 (only 
quadrants O and 2 used for A16) 


Firmware allocates between 512 MB (minimum) and 960 MB (maximum) 
of contiguous PCI dense space for PCI-to-VME windows 0 through 7, based 
on what is configured in the system, and an additional, separate 64 MB for 
the special A24/A16 window. 
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The default windows 0 through 3 consume 512 MB; the default windows 

4 and 5 consume 128 KB. Windows 6 and 7 can be used to map to other 
VMEbus address spaces, module switches, semaphores, location monitors, 
and so on. (However, if your configuration requires more PCI resources than 
are available, the adapter will not be configured.) 


Between the special 64 MB A24/A16 window and the eight other windows, 
all of A16 and A24 space is available for access. The CPU can access a 128 
MB window of A32 space with the default configuration. You have the 
ability to increase or decrease the size of the windows, change the VME bus 
addresses and modifiers, and specify additional VMEbus windows. 


Note 


When configuring PCl-to-VME address spaces, you must ensure 
that all VMEbus devices to which the CPU will perform 1/O are 
configured within one or more of the PCI-to-VME windows. If 
window sizes, VMEbus addresses, or VMEbus address modifiers 
are changed at a later point, you must ensure that the VMEbus 
devices remain within the PCl-to-VME windows. 


During system initialization, if the special A24/A16 PCI-to-VME window 

is enabled (vba_univ parameter VME_A24 A16 Wnd Ena equals 1), the 
UNIVERSE I! adapter support code obtains (from firmware) the PCI address 
of the 64 MB window that will be used for VME bus A24 and A16 accesses 
and configures the window to match your vba_univ attribute settings. For 
more information about configuring the A24/A16 PCI-to-VME window, see 
Section 2.3.3. 


The UNIVERSE II adapter support code then obtains (from firmware) the 
PCI start and end addresses of the contiguous PCI dense space available for 
mapping PCI-to-VME windows 0 through 7. If enough PCI dense space is 
available, windows 0 through 7 are then configured to match your vba_univ 
attribute settings. 


For hardware reasons, PCI-to-VME windows 0 and 4 must be configured on 
a 4KB boundary, and their sizes must be a multiple of 4 KB. The remaining 
six windows must be configured on a 64 KB boundary, and their sizes must 
be a multiple of 64 KB. The sizes of all windows together must not exceed 
the limit provided in firmware. 


Each PCI-to-VME window has the following configurable parameters, which 
you can modify in the form of vba_univ subsystem attributes: 


Window enabled or disabled (Section 2.3.2.1) 
VMEbus base address (Section 2.3.2.2) 
Window size (Section 2.3.2.3) 
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VMEbus address modifiers (Section 2.3.2.4) 
VMEbus maximum data width (Section 2.3.2.5) 
Write posting enabled or disabled (Section 2.3.2.6) 
VME bus cycle type (Section 2.3.2.7) 


When mapping to the VME bus to fulfill a request, UNIVERSE II support 
code searches PCI-to-VME windows 0 through 7 in numerically ascending 
order, comparing the VMEbus address attributes in the request to the 
configured attributes of each window. The first window that satisfies the 
request is used. If none of the windows 0 through 7 satisfies the request, the 
support code checks against the special A24/A16 PCI-to-VME window. 


Note that for A24 and A16 access, the support code’s VMEbus mapping 

algorithm allows windows 0 through 7 to take precedence over the special 
A24/A16 window. If you want to guarantee that CSR accesses are mapped 
through the special A24/A16 window, you must manipulate your system's 


PCI-to-VME window attributes such that the CSR mappings fall through 
to the special window. 


2.3.2.1 Enabling or Disabling a PCI-to-VME Window 


To enable or disable a PCI-to-VME window, you can specify one of the 
following values tothe VME_Wndn_Ena attribute for that window. This value 


is stored in the PCI Slave |mage Control Register corresponding to the 
PCI-to-VME window number (LSIn_CTL). 


0x0 Window is disabled (default for windows 6 and 7) 
Ox1 Window is enabled (default for windows 0 through 5) 


2.3.2.2 Specifying a PCI-to-VME Window VMEbus Base Address 


To establish the VME bus base address for a PCI-to-VME window, you specify 
a hexadecimal address value to the VME_Wndn_ VME Address attribute for 
that window. The value can bein the range 0x0 to OxF FFFFFFF, but the 
window base address and its associated size (VME_Wndn_Size) must fall 
within the addressable range of the VME bus address space (A32, A24, or 
A16) selected for that window. 


Windows 0 and 4 must be configured on 4 KB boundaries; the remaining six 
windows must be configured on 64 KB boundaries. 


2.3.2.3 Specifying a PCl-to-VME Window Size 


To establish the size for a PCI-to-VME window, you specify a hexadecimal 
size value to the VME_Wndn_Size attribute for that window. The value 
can bein the range 0x0 to OxF FFFFFFF, but the window base address 
(VME_Wndn_VME_ Address) and its associated size must fall within the 
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addressable range of the VMEbus address space (A32, A24, or A16) selected 
for that window. 


Windows 0 and 4 must be sized to a multiple of 4 KB; the remaining six 
windows must be sized toa multiple of 64 KB. 


2.3.2.4 Specifying PCl-to-VME Window VMEbus Address Modifiers 


To select the VMEbus address space for a PCI-to-VME window, you can 
specify one of the following values tothe VME_Wndn_ AM Space attribute 
for that window, 0 through 7, to select the VMEbus address space for that 
window. This value is stored in the PCI Slave |mage Control Register 
corresponding to the PCI-to-VME window number (LSIn_CTL). 


0x0 A16 address space 
Ox1 A24 address space 
Ox2 A32 address space 


To select user or supervisory mode for a PCl-to-VME window, you can specify 
one of the following values tothe VME_Wndn AM Usr_ Sprvsr attribute for 
that window. This value is stored in the PCI Slave | mage Control Register 
corresponding to the PCI-to-VME window number (LSIn_CTL). 


0x1 User mode 


Ox2 Supervisory mode 


To select data or program access for a PCI-to-VME window, you can specify 
one of the following values tothe VME _Wndn AM Data_Prg attribute for 
that window. This value is stored in the PCI Slave | mage Control Register 
corresponding to the PCI -to-VME window number (LSIn_CTL). 


0x1 Data access 


Ox2 Program access 


2.3.2.5 Specifying a PCl-to-VME Window VMEbus Maximum Data Width 


To select the VMEbus maximum data width for a PCI-to-VME window, you 
can specify one of the following values tothe VME_Wndn_AM Dwdth attribute 
for that window. This value is stored in the PCI Slave Image Control 
Register corresponding to the PCI-to-VME window number (LSIn_CTL). 

0x0 VMEbus maximum data width =8 bits 


0x1 VMEbus maximum data width = 16 bits 
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Ox2 VMEbus maximum data width = 32 bits (default) 
0x3 VMEbus maximum data width = 64 bits 


2.3.2.6 Specifying PCl-to-VME Window Write Posting 


To enable or disable write posting for a PCI-to-VME window, you can 
specify one of the following values to the VME_Wndn_WP_Ena attribute for 
that window. This value is stored in the PCI Slave | mage Control Register 
corresponding to the PCI-to-VME window number (LSIn_CTL). 


0x0 Write posting is disabled 
Ox1 Write posting is enabled (default) 


2.3.2.7 Specifying a PCI-to-VME Window VMEbus Cycle Type 


To select the VME bus cycle type for a PCI-to-VME window, you can specify 
one of the following values to the VME_Wndn_ Cycle Sel attribute for that 
window. This value is stored in the PCI Slave |mage Control Register 
corresponding to the PCI-to-VME window number (LSIn_CTL). 


0x0 Single cycles only (default) 


Ox1 Single cycles and block transfers 


2.3.3 Configuring a Special A24/A16 PCI-to-VME Window 


As part of configuring the vba_univ kernel subsystem, you can configure 
up to eight PCI-to-VME (PCI slave) windows for your system. Additionally, 
you can map a special A24/A16 PCI-to-VME window, 64 MB in size, for 
VMEbus A24 and A16 accesses. 


The 64 MB window (64 MB aligned) is subdivided into four 16 MB windows. 
The top 64 KB of each 16 MB quadrant is allocated for VMEbus A16 
accesses. The remaining 16 MB minus 64 KB of each quadrant is allocated 
for VME A24 accesses. 


By default, the four quadrants of the 64 MB window are set up with the 
following VMEbus address-modifier attributes. Note that only quadrants 0 
and 2 are used for A16 access. 
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A16 Supervisory Program (not used) High 


Quadrant 3 A24 Supervisory Program 1G ME 


A16 Supervisory Data (64 KB) 


Quadrant 2 A24 Supervisory Data 16 MB 


A16 User Program (not used) 


Quadrant 1 A24 User Program 16 MB 


A16 User Data (64 KB) 


Quadrant 0 A24 User Data 
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For example, an A16 supervisory data access would map to the top 64 KB 
of quadrant 2. An A24 user data access would map to the bottom 16 MB 
minus 64 KB of quadrant 0. 


The special A24/A16 PCI-to-VME window has the following configurable 
parameters, which you can modify in the form of vba_univ subsystem 
attributes: 


Window enabled or disabled (Section 2.3.3.1) 
Write posting enbled or disabled (Section 2.3.3.2) 
VMEbus maximum data width (Section 2.3.3.3) 


During system initialization, if the special A24/A16 PCI-to-VME window 

is enabled (vba_univ parameter VME_A24 A16 Wnd_ Ena equals 1), the 
UNIVERSE II adapter interface obtains (from firmware) the PCI address of 
the 64 MB window that will be used for VME bus A24 and A16 accesses and 
configures the window to match your vba_univ attribute settings. 


2.3.3.1. Enabling or Disabling the A24/A16 Window 


You can specify one of the following values tothe VME_A24 A16 Wnd Ena 
attribute to enable or disable the special A24/A16 PCI-to-VME window. This 
value is stored in the Special PCI Slave | mage Register (SLSI). 
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Ox0 A24/A16 window is disabled 
0x1 A24/A16 window is enabled (default) 


2.3.3.2 Specifying A24/A16 Window Write Posting 


You can specify one of the following valuestothe VME _A24 A16 Wnd WP Ena 
attribute to enable or disable write posting to the A24/A16 window. This 
value is stored in the Special PCI Slave | mage Register (SLSI). 


0x0 Write posting is disabled 
Ox1 Write posting is enabled (default) 


2.3.3.3 Specifying the A24/A16 Window VMEbus Maximum Data Width 


You can specify a 4-bit value from Ox0 toOxF totheVME A24 A16 Wnd Dwdth 
attribute to select the A24/A16 window VMEbus maximum data width for 
each quadrant. This value is stored in the Special PCI Slave | mage Register 


(SLSI). 
Each bit selects D16 (0) or D32 (1) width for the corresponding quadrant, as 
follows: 

Q3 Q2 Qi Qo 


16-bit data width (D16) 
32-bit data width (D32) 


0 0 
1 1 


For example, the value 0x0 (bit value 0000) selects D16 for all quadrants 
and the value OxA (1010) selects D16 for quadrants 0 and 2 and D32 for 
quadrants 1 and 3. The default, OxF (1111), selects D32 for all quadrants. 
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2.3.4 Configuring VME-to-PCI Address Spaces 
As part of configuring the vba_univ kernel subsystem, you can configure up 
to eight VME-to-PCI (VMEbus slave) windows, numbered 0 through 7, tobe 
used for VMEbus slave accesses in your system. 


By default, the following VME-to-PCI windows are provided on your system: 
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Window 0- enabled VMEbus base address 0x00C00000, 4 MB, A24 
user/supervisory data/program; write posting, 
prefetching, and PCI 64 enabled 


Window 1- enabled VMEbus base address 0x08000000, 128 MB, A32 
user/supervisory data/program; write posting, 
prefetching, and PCI 64 enabled 


Window 2 - disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Window 3 - disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Window 4- disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Window 5 - disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Window 6 - disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Window 7 - disabled VMEbus base address 0x00000000, 0, A24 user/supervisory 
data/program; write posting, prefetching, and PCI 64 enabled 


Other windows can be enabled, or enabled windows can be reconfigured. 
All windows must be at least 64 MB in size. Windows 0 and 4 must be 
configured on an 8 KB boundary and must be sized toa multiple of 8 KB 
(minimum 64 KB), in order to line up with the PCI scatter/gather mapping 
register on Alpha based platforms. The remaining six windows must be 
configured on a 64 KB boundary and must be sized to a multiple of 64 KB. 
The sizes of all windows together must not exceed the total amount of 
resources available in the system for VME-to-PCI mapping. The number of 
VME-to-PCI windows enabled in the system, their sizes, and the amount of 
memory in the system determines the PCI resources needed. The maximum 
memory provided for VME-to-PCI mapping resources is determined by the 
VBA_Max_PCI_Sg_Size adapter attribute; the default is 512 MB. 


Each VME-to-PCI window has the following configurable parameters, which 
you can modify in the form of vba_univ subsystem attributes: 


Window enabled or disabled (Section 2.3.4.1) 

VMEbus base address (Section 2.3.4.2) 

Window size (Section 2.3.4.3) 

VMEbus address modifiers (Section 2.3.4.4) 

Write posting enabled or disabled (Section 2.3.4.5) 

Prefetch reads enabled or disabled (Section 2.3.4.6) 

64-bit PCI bus transactions enabled or disabled (Section 2.3.4.7) 
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2.3.4.1. Enabling or Disabling a VME-to-PCI Window 


To enable or disable a VME-to-PCI window, you can specify one of the 
following values to the PCI_Wndn_Ena attribute for that window. This value 
is stored in the VME bus Slave Image Control Register corresponding to the 
VME-to-PCI window number (VSIn_CTL). 


0x0 Window is disabled (default for windows 2 through 7) 


0x1 Window is enabled (default for windows 0 and 1) 


2.3.4.2 Specifying a VME-to-PCI Window VMEbus Base Address 


To establish the VME bus base address for a VME-to-PCI window, you specify 
a hexadecimal address value to the PCI_Wndn_ VME Address attribute for 
that window. The value can bein the range 0x0 to OxF FFFFFFF, but the 
window base address and its associated size (PCI_Wndn_ Size) must fall 
within the addressable range of the VMEbus address space (A32 or A24) 
selected for that window. 


Windows 0 and 4 must be configured on 8 KB boundaries toline up with the 
PCI scatter/gather mapping register on Alpha based systems; the remaining 
six windows must be configured on 64 KB boundaries. 


2.3.4.3 Specifying a VME-to-PCI Window Size 


To establish the size for a VME-to-PCI window, you specify a hexadecimal 
size value to the PCI_Wndn_Size attribute for that window. The value 
can be in the range 0x0 to OxF FFFFFFF, but the window base address 
(PCI_Wndn_ VME Address) and its associated size must fall within the 
addressable range of the VME bus address space (A32 or A24) selected for 
that window. 


All windows must be at least 64 KB in size. Windows 0 and 4 must be 
sized toa multiple of 8 KB; the remaining six windows must be sized to 
a multiple of 64 KB. 


2.3.4.4 Specifying VME-to-PCI Window VMEbus Address Modifiers 


To select the VMEbus address space for a VME-to-PCI window, you can 
specify one of the following values tothe PCI_Wndn AM Space attribute 
for that window. This value is stored in the VME bus Slave | mage Control 
Register corresponding to the VME-to-PCI window number (VSIn_CTL). 
Ox1 A24 address space 


Ox2 A32 address space 
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You can specify one of the following valuestothe PCI _Wndn AM Usr Sprvsr 
attribute for a VME-to-PCI window (0 through 7) to select user mode, 
supervisory mode, or both for that window. This value is stored in the 
VMEbus Slave | mage Control Register corresponding to the VME-to-PCI 
window number (VSIn_CTL). 


Ox1 User mode 
Ox2 Supervisory mode 
0x3 Both user and supervisory mode (default) 


You can specify one of the following values tothe PCI_Wndn AM Data Prg 
attribute for a VME-to-PCI window (0 through 7) to select data access, 
program access, or both for that window. This value is stored in the VMEbus 
Slave Image Control Register corresponding to the VME-to-PCI window 
number (VSIn_CTL). 


Ox1 Data access 
Ox2 Program access 
0x3 Both data and program access (default) 


2.3.4.5 Specifying VME-to-PCI Window Write Posting 


To enable or disable write posting for a VME-to-PCI window, you can specify 
one of the following values to the PCI_Wndn_WP_Ena attribute for that 
window. This value is stored in the VMEbus Slave! mage Control Register 
corresponding to the VME-to-PCI window number (VSIn_CTL). 


0x0 Write posting is disabled 
Ox1 Write posting is enabled (default) 


2.3.4.6 Specifying VME-to-PCI Window Prefetch Reads 


To enable or disable prefetch reads for a VME-to-PCI window, you can specify 
one of the following values tothe PCI_Wndn Pre Rd_ Ena attribute for that 
window. This value is stored in the VMEbus Slavel mage Control Register 
corresponding to the VME-to-PCI window number (VSIn_CTL). 


0x0 Prefetch reads are disabled 
0x1 Prefetch reads are enabled (default) 
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2.3.4.7 Specifying VME-to-PCI Window 64-Bit PCI Bus Transactions 


To enable or disable 64-bit PCI bus transactions for a VME-to-PCI window, 
you can specify one of the following values tothe PCI_Wndn PCI64 Ena 
attribute for that window. This value is stored in the VMEbus Slave 
Image Control Register corresponding to the VME-to-PCI window number 


(VSIn_CTL). 
0x0 64-bit PCI bus transactions are disabled 
0x1 64-bit PCI bus transactions are enabled (default) 


Note 


In order for 64-bit PCI bus transactions to be enabled, the PCI 
Bus Size (LCLSIZE) bit must be set in the Miscellaneous Status 
Register (MISC_STAT). If LCLSIZE is clear, the value of the 
PCI_Wndn_PCI64_Ena attribute is ignored. 


2.3.5 Mapping UNIVERSE II CSRs to the VMEbus 


As part of configuring the vba_univ kernel subsystem, you can map 
UNIVERSE II CSRs (control and status registers) to the VMEbus for your 
system. UNIVERSE II CSRs occupy a 4 KB window and can be enabled to 
support four module switches and eight semaphores. 


Caution 


The default vba_univ adapter configuration maps UNIVERSE II 
CSRs to the VMEbus for VME bus backplane (vb) network driver 
use. Other drivers should not access the CSRs on the VMEbus 
except with extreme caution, because register changes may affect 
adapter code. 


The default configuration of the UNIVERSE II CSRs window on the VMEbus 
is as follows: 


CSR window - enabled VMEbus base address OxF FFF0000, 4KB, A32 
supervisory data/program 


You determine where in VMEbus space the UNIVERSE II CSRs are 
configured by modifying the following vba_univ subsystem attributes: 


CSR window enabled or disabled (Section 2.3.5.1) 
VMEbus base address (4 KB aligned) (Section 2.3.5.2) 
VMEbus address modifiers (Section 2.3.5.3) 
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2.3.5.1. Enabling or Disabling the CSR Window 


You can specify one of the following values to the CSR_Ena attribute to 
enable or disable the CSR window. This value is stored in the VMEbus 
Register Access Control Register (VRAI_CTL). 


0x0 CSR window is disabled 
0x1 CSR window is enabled (default) 


2.3.5.2 Specifying a CSR Window VMEbus Base Address 


To establish the VMEbus base address for the CSR window, you specify 

a hexadecimal address value to the CSR_VME_Address attribute. The 
value can bein the range 0x0 to OxF FF FFFFF, but must fall within the 
addressable range of the VMEbus address space (A32, A24, or A16) selected 
for that window. The CSR window must be configured on a 4 KB boundary. 


2.3.5.3 Specifying CSR Window VMEbus Address Modifiers 


You can specify one of the following values tothe CSR_AM Space attributeto 
select the VMEbus address space for the CSR window. This value is stored 
in the VMEbus Register Access Control Register (VRAI_CTL). 


0x0 A16 address space 
Ox1 A24 address space 
Ox2 A32 address space (default) 


You can specify one of the following values tothe CSR_AM Usr Sprvsr 
attribute to select user mode, supervisory mode, or both for the CSR window. 
This value is stored in the VMEbus Register Access Control Register 


(VRAI_CTL). 

Ox1 User mode 

Ox2 Supervisory mode (default) 

0x3 Both user and supervisory mode 


You can specify one of the following values to the CSR_AM Data_Prg 
attribute to select data access, program access, or both for the CSR window. 
This value is stored in the VMEbus Register Access Control Register 
(VRAI_CTL). 
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Ox1 Data access 
Ox2 Program access 


0x3 Both data and program access (default) 


2.3.6 Mapping a Location Monitor Window to the VMEbus 


As part of configuring the vba_univ kernel subsystem, you can map a 4 KB 
location monitor window to the VME bus for your system. Any read/write 
access to this window triggers interrupts for all UNIVERSE Il-based 
VMEbus modules mapping the window (usable for implementing a global 
interrupt facility). 


Note 


Only UNIVERSE ||-based systems can access UNIVERSE II 
location monitors. Accesses from V1P/VIC-based or other systems 
will cause bus errors. 


The default configuration of the location monitor window on the VME bus 
is as follows: 


Location monitor window VMEbus base address OxF FFF 1000, 4KB, A32 
- disabled supervisory data/program 


This window cannot reside within the VME-to-PCI windows you configure. 


You determine where in VMEbus space the location monitor window is 
configured by modifying the following vba_univ subsystem attributes: 


Location monitor window enabled or disabled (Section 2.3.6.1) 
VMEbus base address (4 KB aligned) (Section 2.3.6.2) 
VMEbus address modifiers (Section 2.3.6.3) 


No specific operating system support exists for the location monitor registers 
and interrupts. To connect to location monitor interrupts, device drivers 
must install interrupt service interfaces for the location monitor interrupts 
and enable or disable location monitor interrupts. 


After the location monitor interrupts are connected, any VME bus read or 
write access to the UNIVERSE II location monitor window mapped to the 
VME bus causes the appropriate location monitor interrupt to be generated 
to all interrupt-connected modules. 


Device drivers must reference the location monitor window specifying 
matching VMEbus base address and modifiers. The device driver is 
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responsible for knowing the location monitor window’s VM E bus base address 
and VMEbus address modifiers. 


2.3.6.1 Enabling or Disabling the Location Monitor Window 


You can specify one of the following values tothe LM_Ena attribute to enable 
or disable the location monitor window. This value is stored in the Location 
Monitor Control Register (LM_CTL). 


0x0 Location monitor window is disabled (default) 


0x1 Location monitor window is enabled 


2.3.6.2 Specifying a Location Monitor Window VMEbus Base Address 


To establish the VME bus base address for the location monitor window, you 
specify a hexadecimal address value to the LM_VME_Address attribute. 
The value can be in the range 0x0 to OxFFFFFFFF, but must fall within 
the addressable range of the VMEbus address space (A32, A24, or A16) 
selected for that window. The location monitor window must be configured 
on a 4 KB boundary. 


2.3.6.3 Specifying Location Monitor Window VMEbus Address Modifiers 


You can specify one of the following values tothe LM AM Space attribute 
to select the VMEbus address space for the location monitor window. This 
value is stored in the Location Monitor Control Register (LM_CTL). 


0x0 A16 address space 
Ox1 A24 address space 
Ox2 A32 address space (default) 


You can specify one of the following values tothe LM_AM Usr_Sprvsr 
attribute to select user mode, supervisory mode, or both for the location 
monitor window. This value is stored in the Location Monitor Control 
Register (LM_CTL). 


Ox1 User mode 
Ox2 Supervisory mode (default) 
0x3 Both user and supervisory mode 


You can specify one of the following values tothe LM AM Data_Prg attribute 
to select data access, program access, or both for the location monitor window. 
This value is stored in the Location Monitor Control Register (LM_CTL). 
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Ox1 Data access 
Ox2 Program access 


0x3 Both data and program access (default) 


2.3.7 Configuring VMEbus Interrupts 


This section addresses VME bus interrupt request levels and how to specify 
VMEbus interrupt parameters to the software. 


2.3.7.1. VMEbus Interrupt Request Levels 


Table 2-6 lists the system priority levels (SPLs) at which VMEbus and 

VME bus adapter interrupt requests are delivered to the operating system 
and device drivers. You can query your system’s VMEbus SPLs at run time 
by issuing the command sysconfig -q vba_univ. 


Table 2-6: UNIVERSE II VMEbus Interrupt Request Levels 
Interrupt Request Name Alpha VME SBC SPLs 


VMEbus IRQ 1 SPLDEVLOW 
VMEbus IRQ 2 SPLDEVLOW 
VMEbus IRQ 3 SPLDEVLOW 
VMEbus IRQ 4 SPLDEVHIGH 
VMEbus IRQ 5 SPLDEVHIGH 
VMEbus IRQ 6 SPLDEVHIGH 
VMEbus IRQ 7 SPLDEVRT 
VMEbus Reset SPLDEVRT 
Module Switches SPLDEVRT 
Location Monitors SPLDEVRT 
Adapter Errors SPLDEVRT 
VMEbus |IACK SPLDEVLOW 
DMA Status SPLDEVRT 


Alpha VME SBCs do not support autovector requests. 


As Table 2-6 indicates, Alpha VME SBCs generate interrupt requests that 
higher-level interrupt requests can preempt. 


On the Alpha VME SBCs, device drivers must usethe rt_post_callout 
routine for interrupts delivered at SPLDEVRT. Interrupt requests for which 
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this is needed are VMEbus IRQ7, any of the four module switch interrupts, 
and any of the four location monitor interrupts. 


2.3.7.2 Setting VMEbus Interrupt Vector Parameters 


You specify vectors and interrupt requests (IRQs) for a device driver using 
the Vector and Bus Priority fields of a VBA_Option entry in the 
/etc/sysconfigtab file or ina sysconfigtab file fragment. 


Device drivers are passed this information in the controller structure 
elements ivnum and bus priority. 


VMEbus interrupt vectors 24 to 255 are available to device drivers. Vectors 
0 to 23 are reserved by the VME bus adapter. When you specify a vector to 
the vector field of VBA_Option, you must alsousetheBus Priority field 
to specify an IRQ. Valid IRQ specifications are values 1 through 7. These 
values correspond to VME bus levels |RQ1 through IRQ7. 


See the Autoconfiguration Support section of Writing VMEbus Device Drivers 
(available in the Device Driver Kit) for an example of adding and enabling 
VMEbus interrupts. See the vme_handler_info structure in Writing 
VMEbus DeviceDrivers for interrupt handler information. 


2.3.7.3 Specifying Module Switch Interrupt Vectors 


Specify one of the following vectors in the vector field of VBA_Option to 
select the module switch interrupt you want. Usethe Bus Priority field 
to specify 7 as the IRQ level. 


Module switch 0 Vector 0x1140 [CSR offset 0x348] 
Module switch 1 Vector 0x1150 [CSR offset 0x34C] (default) 
Module switch 2 Vector 0x1160 [CSR offset 0x350] 
Module switch 3 Vector 0x1170 [CSR offset 0x354] 


Module switch interrupt vectors allow a module to issue an interrupt to 
itself or to another module. The autoconfiguration software provides control 
and status registers (CSRs) for use in module switch interrupts. You can 
specify two CSRs ina VBA_Option entry in the /etc/sysconfigtab file 
or in asysconfigtab file fragment. At boot time, the system searches 
for the specified CSRs. 


The autoconfiguration software performs the appropriate bus mapping and 
provides io handle _ t valuesin the addr and addr2 members of the 
driver’s controller structure. The addr argument is passed to the driver's 
probe routine, while the addr2 value must be obtained from the addr2 
member of the controller structure. 
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For example, the following VBA_Option entry specifies an A32 window 
address as the CSR base address. The module switch 1 CSR is an offset 
from this A32 address. 


VBA_Option = Csrl - OxFFFFO000, ..., Vector - 0x1150, Bus Priority - 7, ... 


The driver structure allows you to specify the size and address type for 
the CSRs. For example, the following members in a driver structure 
indicate that the first CSR has a size of 4096 (x1000) bytes and is in the 
A32 supervisory data address space: 


int addrl_size 4096 
int addrl_atype VME_A32_SDATA 


For more information, see the Device Driver Kit manuals Writing Device 
Drivers and Writing VMEbus Device Drivers, especially the sections on 
the addr and addr2 members of the controller structure and on the 
addrl_size,addrl_atype, addr2_size, and addr2_atype members of 
the driver structure. 


In addition, you can use the vba_map_csr routine to provide module switch 
interrupts. After using the vba_map_csr routine to create an I/O handle, 
you write to an address derived from the base address plus an offset. The 
following code fragment shows how the!/O handle is created: 

io_handle t ioh; /* Define type of ioh */ 

vme_addr_t VME_base=0xFFFF0000; /* Base CSR address */ 


ioh = vba_map_csr(ctlr, VME_base, 4096, 
(VME_A32_SDATA) ) ; 


The following code fragment shows how the module switch interrupts are 
issued: 
write_io port (ioh+0x34C, 1, 0, data) /* Write to CSR base address 

plus the offset to cause 


module switch 1 interrupt */ 
mb () ; 


2.3.7.4 Specifying Location Monitor Interrupt Vectors 


The location monitor interrupt vectors are as follows: 


Location monitor 0 Vector 0x1100 
Location monitor 1 Vector 0x1110 
Location monitor 2 Vector 0x1120 
Location monitor 3 Vector 0x1130 


No specific operating system support exists for the location monitor registers 
and interrupts. To connect to location monitor interrupts, device drivers 
must install interrupt service interfaces for the location monitor interrupts 
and enable or disable location monitor interrupts. 
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When location monitor interrupts are connected, any VMEbus read or write 
access tothe UNIVERSE II location monitor window mapped tothe VME bus 
causes the appropriate location monitor interrupt to be generated to all 
interrupt-connected modules. 


For more information about configuring the UNIVERSE II! location monitor 
window, see Section 2.3.6. 


2.3.8 Using VMEbus Software Byte Swapping 


Alpha processors are little endian, while VME bus is big endian. The default 
operation of the UNIVERSE II adapter causes the transfer of bytes between 
Alpha processors and VMEbus to be arranged correctly. If, however, a 16-bit 
or 32-bit number is needed in a VMEbus register, the default operation 
rearranges the bytes within the transfer such that the bytes are reversed 

in significance 


For UNIVERSE Il-based Alpha VME systems, software byte swapping must 
be used to handle these situations. (By contrast, VIP/VIC-based Alpha VME 
systems use hardware byte-swapping modes.) 


For VMEbus device drivers, the Device Driver Kit (DDK) provides a VMEbus 
example device driver, DMAEX, and accompanying user code that offers a 
model for how you can implement software byte swapping. You can obtain 
VMEbus driver-writing documentation by purchasing a DDK, or you can 
browse a subset of DDK materials in the Library section of the Compaq 
Tru64 UNIX web site, currently located at: 


http://www.unix.digital.com/faqs/publications/pub_page/ devdoc _list.html 
Be sure to check for the latest DDK technical updates at the same location. 


If your VMEbus device driver code must be portable across both 
VIP/VIC-based and UNIVERSE II-based Alpha VME systems, you can 
code the driver to use hardware or software byte swapping according to 
the system type. 


2.3.9 Sharing Memory Between Big Endian and Little Endian 
Processors 


In ashared memory environment, where packed data structures in common 
memory are shared between an Alpha processor (little endian) and a big 
endian processor, software byte swapping is required to arrange bytes 
properly for 16- or 32-bit quantities (such as 16-bit counter values or 32-bit 
VMEbus address values). 
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2.3.10 


2.3.11 


The following combination is recommended: UNIVERSE II default operation 
with software byte swapping on nonbyte data for the Alpha processor, and 
no swapping on the big endian processor. 


You could implement software swapping with read/write macros that 
perform the swap with the following code. The purpose here is to provide 
code that would run on both little endian and big endian machines that 
have shared memory. 


define read_word/long(iohandle, data) / 
data = read_io port (iohandle, sizeof (word/long) ,0) ;/ 
ifdef LITTLEENDIAN iff 
swap_xx (data) ; / 
else /* BIGENDIAN +*/ / 
endif 
define write _word/long(iohandle, data) / 
ifdef LITTLEENDIAN / 
swap_xx (data) ; / 
else /* BIGENDIAN */ / 
write _io_ port (iohandle, sizeof (word/long) ,0,data); / 
endif 


Performing VMEbus Slave Block Transfers 


Alpha VME platforms are configured during adapter initialization to accept 
slave block transfers (SBLTs) with data widths of D08, D16, D32, or D64. 
After the SBC has mapped its memory onto the VMEbus by using the 
dma_map_alloc and dma_map_load routines, no other user interaction is 
needed. For information on calling the dma_map_alloc and dma_map_load 
routines, see the corresponding reference pages in the Device Driver Kit 
(available separately from the base operating system). 


Memory must be mapped to the VME bus prior to D64 slave access. 


Access to memory must coincide with the configured access mode. By 
default, all access is allowed (Supervisory and user, program and data). 
You can constrain access by modifying the default window mappings. See 
Section 2.3.4 for more information about configuring VME-to-PCI address 
spaces. 


Performing VMEbus Master Block Transfers with Local DMA 


The VMEbus interfaces for Alpha VME platforms provide a block-mode 
DMA engine. This DMA engine is capable of transferring up to 16 MB 
minus 2 KB of data without processor intervention, in VMEbus data widths 
of D08, D16, D32, or D64. 


The DMA engine transfers data from the VM Ebus to system memory (read) 
or from system memory to the VMEbus (write). The hardware interface 
handles the segmentation of the transfer. This ensures that the VMEbus 
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specification is not violated in relation to crossing VME bus 256-byte 
boundaries for D16 and D32 or 2 KB boundaries for D64. 


The DMA engine is configured to give up the VME bus during the transfer 
and to rearbitrate for the VMEbus again to continue the DMA. Thetime 
between when the DMA engine gives up the bus and rearbitrates for the bus 
is called the interleave period. During the interleave period, single-cycle 
VMEbus cycles, receipt of slave block transfers (SBLTs), or other operations 
may be performed. 


The master block transfer (MBLT) hardware interface presents address 
modifiers of user block or supervisory block to the VMEbus, based on 
parameters passed in the software programming interface. The device or 
system on the VME bus must be able to interpret these address modifiers; 
otherwise, bus errors may occur. 


You can use the MBLT hardware interface to: 


¢ Transfer data to and from those VME bus devices that do not have their 
own DMA engine 


« Move data between VMEbus device memory and system memory 


¢ Transfer data to and from other systems that have their memory mapped 
to the VMEbus 


The MBLT hardware interface supports DMA block-mode transfers to and 
from VMEbus A24 and A32 address space only. 


Routines for Master Block-Mode Transfers 


To use master block transfers (MBLTs) with the local hardware DMA engine, 
you must invoke the following routines and supply specific flag values: 


vba_set_dma_addr 
dma_map_alloc 
dma_map_load 
vba_dma 
dma_map_unload 
dma_map_dealloc 


For information on calling these routines, see the corresponding reference 
pages in the Device Driver Kit (available separately from the base operating 
system). 


The flag values DMA_IN and DMA_OUT have specific meaning for VMEbus 
support with respect tothe dma_map_alloc, dma_map_load, and vba_dma 
routines. These flags indicate to the low-level VMEbus dma_map_ alloc, 
dma_map_load, and vba_dma routines that the MBLT hardware DMA 
engine is to be used and the direction of the transfer. 
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Specifying DMA_IN implies a read from the VMEbus to system memory. 
Specifying DMA_OUT implies a write from system memory to the VME bus. 
You use the vba_set_dma_addr routine to pass the flag values and the 
VMEbus address at which the transfer is to occur. 


The VMEbus block-mode DMA engine on the VMEbus adapter is a single 
entity that must be shared among various device drivers. Specifying 
DMA_SLEEP causes the device driver to block in the vba_dma routine if the 
DMA engine is already being used. If DMA_SLEEP is not specified and the 
DMA engine is being used, vba_dma returns an error. 


The following sample code shows how to invoke the MBLT hardware DMA 
engine for a block-mode read operation. The code uses a VME bus transfer 
width of D32 to invoke a 256 KB transfer from VMEbus address A24 
0x400000 to system memory. The code also allocates resources to handle 
transfers up tol MB insize. This allows dma_map_load and vba_dma to be 
invoked multiple times with varying size buffers. You can change the code to 
perform writes by substituting DMA_OUT for DMA_IN. 


struct controller *ctlr; 


vme_addr_t vme_addr = 0x40000; 

unsigned long max_be = (1024*1024) ; 

unsigned long rtn_bc; 

char *buffer; 

unsigned long buffer_bc = (1024 * 256); 

sglist_t dma_handle = (sglist_t) NULL; 

vme_atype _t flags = (VME_A24 UDATA_D32|DMA_IN|DMA SLEEP) ; 
int rtn_flags; 

/* 
* Allocate a buffer (256 KB) to be used for the transfer 
*/ 

MALLOC (buffer, (char *) ,buffer_bc,M DEVBUF,M WAITOK) ; 

/* 


* Specify a VMEbus address of 0x40000 
* Specify flags 

os A24 address space 

= User mode 

* Select DMA engine for a read (DMA_IN) and 
* wait for DMA engine (DMA SLEEP) 


*/ 
rtn_flags = (int)vba_set_dma_addr(ctlr,flags,vme_addr) ; 
/* 
* Allocate DMA resources for up to 1 Mbyte transfer 
* Specify flags returned from vba_set_dma_addr() above 
* The return value from dma_map_alloc() should equal max_bec 
*/ 
rtn_bc = dma_map_alloc(max_bc,ctlr, &dma_handle,rtn_flags) ; 
/* 


* Call dma_map_load() to load the resources for the 


* DMA block-mode engine 

7 Specify the dma_handle returned from dma_map_alloc() 

x Specify flags returned from vba_set_dma_addr() 

a The return value from dma_map_load() should equal buffer_bc 
*/ 


rtn_bc = dma_map_load(buffer_bc, 
(vm_offset_t) buffer, 
0, 
ctilr;, 
&dma_handle, 


Configuring the VMEbus for Alpha VME Systems 2-65 


2.3.11.2 


2.3.12 


0, 
rtn_flags) ; 

/* 

* Call vba_dma() to start up and monitor the VME adapter’s block-mode 
* DMA engine. Specify the dma_handle returned from dma_map_alloc. 

* The return value from vba_dma() is the actual bytes transferred. 
= This value should be the same as value buffer_bc. If not, then 

st an error was detected during the transfer. 


a 
rtn_be = vba_dma(ctlr,dma_handle) ; 
/* 
* Unload and free DMA resources 
e/ 


dma_map_unload(0,dma_handle) 
dma_map_dealloc (dma_handle) 


Restriction on VMEbus Master Block Transfers 


The following restriction applies to using master block transfers (MBLTs) on 
UNIVERSE Il-based Alpha VME platforms: The data buffer address and 
the VMEbus transfer address must be aligned exactly; that is, the 2 lowest 
bits must match. 


For the best DMA performance, the data buffer address and the VMEbus 
transfer address should be word-aligned for D16, longword-aligned for D32, 
or quadword-aligned for D64. 


Using the Realtime Interrupt-Handling Routine rt_post_callout 


Interrupt service interfaces (ISIs) executing at SPLDEVRT (SPL 6) must 
not call kernel routines directly. Thert post callout routine allows the 
calling process to defer execution of a function until a time when kernel 
routines can be invoked. The function invoked by rt_post_callout runs 
at an elevated SPL and is subject to the same restrictions as an ISI. 


The syntax for the function invoked by rt_post_callout is as follows: 
int (*function) (), 


long argl, 
long arg2 ); 


The parameters for the rt_post callout routine areas follows: 


function Name of the function to be invoked 
argl The first argument passed to the function 
arg2 The second argument passed to the function 


If rt_post_callout is called again with the same function and arguments 
specified, then the duplicate invocation is dismissed before the first 
invocation has executed. 
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The following example is for an interrupt service interface (ISI) that runs 
at SPLDEVRT: 


rt_dev_intr (unit) 
int unit; 


register struct rt_softc *sc = rt_softc[unit]; 
rt_post_callout (user_wakeup_interface, /* User wakeup function */ 
(long) &sc->error_recovery flag, /* Event to wake*/ 


(long) NULL) ; /* Unused argument */ 
return; 


} 


The following example shows a user-written function to wake up an event 
called by the rt_post_callout routine: 


void user _wakeup_interface ( argl, arg2 ) 
long argl; 
long arg2; 
{ 
thread_wakeup( (vm_offset_t) argl)j; 


} 
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Configuring a VMEbus Backplane (vb) 
Network 


This chapter explains how to set up a VMEbus backplane-based network in 
which Alpha VME single-board computers (SBCs) operate as Ethernet nodes. 


The VMEbus backplane (vb) interface provides access to an Ethernet 
network through the VME bus backplane driver, which acts as an Ethernet 
Datalink Layer driver. This interface allows VME bus-based systems to 
communicate directly over the VMEbus to other VME bus-based systems on 
the same backplane, or on other Ethernet-connected systems outside the 
backplane through a gateway node on the backplane. 


Both the Tru64 UNIX and VxWorks for Alpha (Version 3.1 or higher) 
software support the vb driver as well as communication between these 
systems on the same backplane. The Tru64 UNIX vb driver is supported on 
AXPvmeand Alpha VME SBCs and on Alpha VME 2100 systems. 


The VMEbus backplane interface requires you to modify the 
/etc/sysconfigtab file on your AXPvme or Alpha VME system in order 
to configure the vb driver and to map VMEbus windows for the system. 
Mapping the VME bus windows on one node requires knowledge about every 
node in the vb network. 


Note 


Do not modify any vme_vba kernel subsystem attributes. To 
configure a vb network node, you modify attributes of the vb 
driver (vb:) and the system’s VMEbus adapter (vba_vipvic: or 
vba_univ:). 


This chapter addresses the following topics relating to the use of the vb 
interface on Alpha VME systems: 


¢ VMEbus backplane (vb) network overview (Section 3.1) 
¢ Configuring vb network nodes (Section 3.2) 

¢ Modifying vb driver attributes (Section 3.3) 

¢ Modifying vba_vipvic adapter attributes (Section 3.4) 
¢ Modifying vba_univ adapter attributes (Section 3.5) 
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¢« \VIP/VIC two-node network example (Section 3.6) 

¢ UNIVERSE II two-node network example (Section 3.7) 
¢ Related ioct1 commands (Section 3.8) 

¢ Diagnostic messages (Section 3.9) 

¢ Errors (Section 3.10) 


3.1 VMEbus Backplane (vb) Network Overview 


Tru64 UNIX provides a VMEbus backplane (vb) driver that allows systems 
to communicate over a VMEbus backplane using Ethernet protocols. 


The backplane driver is compatible with the other parts of the network 
subsystem; that is, all higher-level network protocols are immediately 
available over the backplane, just as they are over the Ethernet. Socket 
communication, remote login, remote file access, NFS, and remote 
procedure calls are all simultaneously available to and from any processor 
on the backplane. Using these network facilities over the backplane is 
indistinguishable from using any other network medium. 


By default, the vb driver is not configured to run when the system is booted 
and must be explicitly turned on for the node to participate in the backplane 
network. 


Configuring nodes in a vb network can be simple or complex, depending on 
the specific system needs. At a minimum, you must configure the vb driver 
to be turned on and you must specify the Ethernet hardware address of the 
target system. By default, an unconfigured driver will not start up. 


You can use all other default vb characteristics without change, as long as 
you configure the necessary system VME bus window space correctly. You 
can also tailor several backplane node characteristics to meet specific system 
and application needs. 


VMEbus addresses are used in two ways in the vb driver: 
* Tomap local memory onto the VME bus for client message queues 
¢ Tointerrupt nodes on the vb network when data is sent 


The following subsections describe how VME bus addresses are used for 
client communication and for interrupting nodes on the vb network. 


3.1.1 VMEbus Addresses Used for Client Communication 


A vb network is made up of two or more nodes in a VMEbus backplane cage 
that communicate by way of local memory mapped onto the VME bus. Nodes 
that participate in the vb network provide local memory for client message 
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queues. Other backplane nodes map to this memory over the VMEbus and 
write data to this local memory; this is what is meant by "sending" messages 
to a node on the backplane network. 


The VME bus has three different basic address spaces to which system 
VMEbus windows may be mapped: A16, A24, and A32. Each systemina 
VMEbus backplane must configure a client communication VME bus window 
(and a mailbox-interrupt VMEbus window, discussed later) in a unique 
manner, such that the windows do not overlap across the backplane. See 
Section 2.2 (VIP/VIC-based Alpha VME systems) or Section 2.3 (UNIVERSE 
1|-based Alpha VME systems) for more information on configuring VME bus 
address spaces. 


The vb driver uses either A24 or A32 space to map its client communication 
queues (data) to the VMEbus. You specify the following information 
regarding the queues for each backplane node: 


¢ The address space in which to map the queues (A24 or A32) as well as 
other address space modifiers (Supervisory/user, program/data) 


¢ Theaddress within A24 or A32 space at which the queues will be mapped 
to the VMEbus, specified as an offset from the base of the queues’ chosen 
system VMEbus window 


¢« The total size of the area needed to map the communication queues 


Default values are defined for these items, but you can reconfigure your 
vb and VMEbus characteristics by adding or modifying values in the 
/etc/sysconfigtab file, as described in Section 3.2. 


Whatever you configure the values to be, you must modify the client 
communication window to accommodate the chosen values. The window 
(A24 or A32) base and size specified must be unique across the backplane, 
and its size must be big enough to fit the queue size specified, starting at the 
offset specified. 


You can configure VMEbus windows on a per-system basis by adding or 
modifying values for each window’s VME bus base address and size in the 
/etc/sysconfigtab file. See Section 2.2 (VIP/VIC-based Alpha VME 
systems) or Section 2.3 (UNIVERSE II-based Alpha VME systems) for more 
information on modifying the base address and size of VME bus windows. 
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Note 


If you do not uniquely configure the client communication 
VMEbus windows for the backplane nodes on the vb network, 
unpredictable behavior may occur. An error message similar 
to the following prints to the console of a node whose client 
communication VME bus window overlaps that of a node that has 
mapped the window and is actively communicating through it, 
even if it is with a device other than the vb driver: 
vba0 errors_inter: VIP/VIC errors detected 

VIC BESR 0x50 - VIP BESR 0x40400 VIC DMASR 0x8 

VMEbus timeout 


local bus error - LBERR* asserted to VIC 
Inbound error - invalid s/g or VMEbus slave access error 


3.1.2 VMEbus Addresses Used for Interrupting 


Module-switch (mailbox-interrupt) settings regulate interrupt activity in the 
vb backplane network. When a node sends data to another node, the sending 
node generates an interrupt on the receiving node by using module switches. 


An interrupt is generated by writing toa particular offset from the base of 
a mailbox-interrupt window, which is an A16 (VIP/VIC) or A16/A24/A32 
(UNIVERSE II) VMEbus window on the node to beinterrupted. The offset 
determines the particular module switch to use for interrupting a node. 


You must configure each node’s mailbox-interrupt window to be unique 
across the nodes in the VMEbus backplane. You can configure VMEbus 
windows on a per-system basis by adding or modifying values for 

each window's VME bus base address and associated attributes in the 
/etc/sysconfigtab file. See Section 2.2 (VIP/VIC-based Alpha VME 
systems) or Section 2.3 (UNIVERSE II-based Alpha VME systems) for more 
information on modifying the base address and size of VME bus windows. 


Four module switches are associated with each node’s mail box-interrupt 
window. You specify the module switch to use for interrupting by adding or 
modifying values for the following driver attributesin /etc/sysconfigtab: 


« A module-switch offset valuein VB Mailbox Offset 


¢ A module-switch vector number in the vector field of the VBA_Option 
entry 


« For UNIVERSE Il-based Alpha VME systems, VMEbus address 
modifiers for the mailbox-interrupt window in VB Mailbox Addr Type 


Additionally, you must verify that the vB_Interrupt_ Interface attribute 
is set to 1 to select interrupt mode over polling mode. 
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If you prefer, you can use the default module-switch offset and vector values, 
which select module switch 1. Adapter-specific offset and vector values are 
listed in Section 3.3. 


Whatever you configure the values to be, you must modify the A16 (VIP/VIC) 
or A16/A24/A32 (UNIVERSE II) mailbox-interrupt window base address to 
be unique among the nodes in the VME bus backplane for interrupting to 
work. (Only one node in the backplane can use the default mail box-interrupt 
window base address.) 


However, you can configure the module switch used tointerrupt a particular 
node individually on a per-node basis (not necessarily uniquely). 


3.1.3 Box Manager Node 


Because a vb network is made up of two or more nodes in a VMEbus 
backplane cage that communicate via local memory mapped onto the 
VMEbus, information about which nodes are participating in the network 
must be stored sothat all nodes can access this information. The information 
is stored in the local memory of a single backplane node, called the box 
manager. 


The box manager node is a special client in that it maps this global 
information onto the VMEbus in addition to mapping its client 
communication queues. 


The box manager maps the global information onto the VMEbus at an 
address that is known toall other nodes in the backplane network (the 
well-known address). When non-box-manager nodes boot, they read 
information from the well-known address to see what other nodes are 

in the network. The well-known address must reside in the particular 
system VMEbus window (A24 or A32) with modifiers (supervisory/user, 
program/data) that are also well Known to other nodes in the vb network. 
The combination of the address and its modifier uniquely specifies where the 
box manager global data resides on the VME bus for all nodes to see. 


The well-known address is configurable through /etc/sysconfigtab and 
defaults to OxBCO000. The address space that it is mapped to (A24 or A32) is 
also configurable and defaults to A24 address space, supervisory mode, and 
data space. (For more information on configuring the well-known address 
and modifiers, see Section 3.3.2.) 


The network administrator must configure only one node to be the box 
manager node. A node is a box manager if the well-known address is 
contained within the node's system VMEbus window (either A24 or A32, 
depending on the configured value of the box manager address modifier). 
No other switch or value specification is needed to identify a box manager. 
Note that you do not have to set the base VMEbus window address to the 
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well-known address; the well-known address must simply be contained 
within a valid VMEbus system window. 


When a node boots, it determines whether or not it is the box manager node 
by comparing the well-known address to its configured system VMEbus 
window range. A node that is not the box manager node is called a client 
node. 


The box manager node is also just another network client, and it has local 
communication queues mapped to the VME bus just like any other client. 
The difference is in the placement of those queues mapped onto the VME bus. 
The box manager has two sets of data that must be mapped to the VM E bus: 
the box manager global data and the client communication queues. 


By default, box manager global data and client communication queues are 
mapped to the same address space, A24. In the default case: 


¢ The offset of the communication queues from the base window specified 
in /etc/sysconfigtab for the queues is ignored. 


¢ Thecommunication queues are mapped directly following the global data 
starting at the well-known address. 


In addition, the combined size of the global data and the communication 
queues is adjusted to be equal to the configured size of the communication 
queues (the default for which is 0x40000, or 256 KB). You do not need to deal 
with the size of the box manager global data when you determine what your 
system VME bus window size should be for the box manager node. 


However, you can configure the global data and the communication 

queues to be mapped to different spaces (A24 and A32). In this case, the 
communication queues are mapped like any other client node. They are 
mapped at the configured offset from the base of its configured window. The 
global data is mapped to the well-known address, for a size of Ox6000 bytes. 
You must be sure that both system windows, A24 and A3z2, will accommodate 
either the well-known address or the communication queues. 


The box manager node must be the first node in the backplane to boot, so 
that the global memory is mapped to the well-known address before other 
nodes attempt to read from it. 


You must boot the VMEbus system controller for the VME bus crate (set 

by the appropriate jumper on the module) before any other node that is 
participating in the vb backplane and before any other node that is using the 
VMEbus. This is because when the system controller is booted, it can reset 
the VME bus registers of all other nodes. If the VMEbus system controller 

is not the box manager, ensure that the system controller boots before the 
box manager node, or that the system controller is not booted while the vb 
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network is up and running. Note that if the the system controller is not the 
box manager, the system controller cannot participate in the vb network. 


3.1.4 Network Participation 


Nodes in a backplane network communicate via memory mapped onto the 
VMEbus. If this memory becomes unmapped, or if the VMEbus is reset for 
any reason, the mapping is nolonger valid. Any read or write operations toa 
remote node that uses the invalid mapping could cause a panic or machine 
check on the system performing the read or write. To reduce the possibility 
of this occurring, the nodes in the vb network maintain liveness with the 
rest of the network. 


To maintain liveness, when a node enters the vb network, it begins 
continually updating a counter in the global memory called its heartbeat. 
In addition, all nodes on the network continually check the vb heartbeat of 
other nodes, including the box manager node, to see if they are still alive and 
able to participate in the network in a timely manner. 


If the heartbeat of a remote node is no longer being updated, communication 
to that node must stop in anticipation of the remote node’s VMEbus mapping 
becoming invalid. For example, if a node is rebooted, its heartbeat ceases 

to be updated and the rest of the backplane nodes eventually lose liveness 
with that node and stop communicating with it. 


When a node is shut down in a controlled manner (using 
/usr/sbin/shutdown), the vb driver notifies the other vb nodes that it is 
shutting down, so that they can stop communicating. If a node is shut down 
in an uncontrolled manner (panic or halt), the current VMEbus mappings 
remain valid until you reinitialize the system. This allows time for other vb 
network nodes to lose liveness with the node before an invalid mapping 
reference occurs. 


After you fully reboot the shutdown node, it can reenter the vb network and 
be seen by the other vb network nodes again. 


If node A loses liveness with node B, node B cannot reenter the vb network 
without rebooting. You cannot restart the vb driver without rebooting. This 
restriction is due to the need for the restarting node to probe the well-known 
address to see if a box manager memory is mapped to the well-known 
address. This probing is supported only during the booting stage. 


Response time is an important aspect of liveness. Even if a node is not shut 
down, it may respond too slowly to vb network traffic to be considered alive. 
In these cases, it may bein the best interest of the rest of the vb network 
to cease communication with that node. For example, a node may have a 
realtime application running at a realtime priority above that of the vb 
network driver, and in fact higher than many system functions. Without 
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network traffic being processed in a timely manner, backups or message | oss 
could occur on any node attempting to send data to the node. 


The liveness feature of the drivers allows remote nodes to notice that 

the node's heartbeat is not being updated (because the node is devoted 

to the realtime application) and stop attempting to communicate with it. 

In addition, you could use a long liveness interval in a stable network 
configuration (one that does not expect frequent shutdowns) to allow a light 
load on the vb network to continue in the midst of expectedly high realtime 
priority usage. 


3.2 Configuring vb Network Nodes 


To configure a vb network node, you perform the following steps: 


1. 


Examine the default or current configuration attributes of the vb 
driver (vb:) and of the system’s VMEbus adapter (vba_vipvic: or 
vba_univ:). 

If an existing vba_vipvic: Or vba_univ: entry in 
/etc/sysconfigtab indicates that adapter defaults have already been 
modified for other VME bus device drivers in the system, you must factor 
the needs of other drivers into any changes you make for the vb driver. 


As needed, modify the /etc/sysconfigtab file to add or modify 
values for vb driver and VMEbus adapter attributes. You must turn 
on the vb driver and you must specify the node’s Ethernet hardware 
address. Also, as part of modifying VMEbus adapter attributes, you 
need to configure each node’s VMEbus system windows with the other 
participating nodes’ VME bus window configurations in mind. Sections 
that follow describe these tasks in detail. 


Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain private 
sysconfigtab file fragments for vb and VMEbus adapter 
attributes and use sysconfigdb switches to add (-a -f), 
delete (-d), or merge(-m -£) attribute values for a particular 
subsystem. The examples in Section 3.6 and Section 3.7 
illustrate this approach. 


Reboot the vb node. You must always reboot after modifying driver 
or adapter subsystem attributes. 


When a configured vb node boots, you must usethe net setup command 
to register the vb driver as a new network driver. Assign each vb node a 
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unique !P address that is a subnet used exclusively by the vb network, 
to differentiate between the Ethernet network and the vb network. 

The participating nodes must be specified in the /etc/hosts file. For 
information on setting up a new network, see Network Administration. 


You must configure and boot the box manager node before configuring and 
booting any other nodes. Also, if the box manager is not the VMEbus system 
controller, the VME bus system controller module must boot before the box 
manager. Otherwise, when the system controller is booted, it may reset the 
entire VMEbus backplane network. 


When you boot each configured node, the VME bus backplane driver becomes 
available. During the boot, the console displays diagnostic messages prefixed 
with the string vB:. The box manager displays the following message at 
startup: 


VB: This is the box manager node 


A dient (non-box-manager) node displays the following message at startup: 


VB: Box mgr address space is not configured for this system, 
thus this node is not the box manager node (OK). Be sure 
that there is a box manager in the network. 


Caution 


Make sure that only one node comes up as the box manager. If 
more than one node comes up as the box manager, it means that 
the system VME bus address window has been configured to 
contain the well-known address (whose default is OxBCOO00) on 
more than one node. This results in unpredictable behavior and, 
at a minimum, causes the vb network to fail. 


3.3 Modifying vb Driver Attributes 


The vb driver attributes are configurable on a per-node or per-vb-network 
basis, as described in detail in this section. 


First you examine the default or current configuration attributes of the vb 
driver and the system's VME bus adapter. Table 3-1 lists the default values 
for vb driver parameters. 


Table 3-1: VMEbus Backplane (vb) Network Driver Defaults 
Parameter Default Meaning 


Per-node vb attributes: 
Module Config Name vb Driver name is vb 


VB Startup State 0 Driver is off 
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Table 3-1: VMEbus Backplane (vb) Network Driver Defaults (cont.) 


Parameter 


Default 


Meaning 


VB_ Client Addr Type 


VB Client Vme Window Size 


VB_ Client Vme_Win- 
dow_Offset 


VB_ Interrupt Interface 


VB _Liveness Timeout 


VB_ Mailbox Addr Type 


VB_Mailbox_ Offset 


VB_Maxnodes 


VB_Netid 


VB _Give_Up 


VB_ Probe Period 


VB_Census_Change 


VB_ Transfer Type 


VB_DMA Threshold 


VB_DMA_Dwidth 


Ox7 


0x40000 


0x0 


256 


Client communication window 
address modifiers: A24 space, 
supervisory mode, and data access 


Size of communication queues 
area is 256 KB 


Map client queues at offset 0x0 
from the client communication 
window base address 


Message response is interrupt 
driven 


Remote liveness tests are 10000 
milliseconds (10 seconds) apart 


(UNIVERSE II only) Client 

mail box-interrupt window address 
modifiers: A16 space, supervisory 
mode, and data access 


Module switch 1 is selected by 
offset 0x23 (VIP/VIC) or 0x34C 
(UNIVERSE I1) 


Maximum nodes allowed in the 
vb network is 10 


Ethernet hardware address of 
the node must be supplied for 
the network to start up 


Time out if the VB_Probe Period 
is exceeded 


Number of minutes to probe the 
box manager’s well-known address 
before exiting driver is 1 


Do not display node mapping 
state changes 


Use only programmed I/O (PIO) 
transfers over the bus 


If VB_Transfer_Type equals 1, 
transfers equal to or exceeding 
256 bytes will use direct memory 
access (DMA) rather than PIO 


If VB_Transfer_ Type equals 1, 
the D16 data width will be used for 
DMA transfers over the bus 
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Table 3-1: VMEbus Backplane (vb) Network Driver Defaults (cont.) 


Parameter Default Meaning 
Per-network vb attributes: 
VB_Box_ Mgr WK Addr OxBCO000 Box manager’s well-known 


VMEbus address is OxBCO000 
(must match on every node) 


VB_Box Mgr WK Addr Type Ox7 Box manager global data address 
modifiers: A24 space, supervisory 
mode, and data access (must 
match on every node) 


VB_Maxmtu 1500 Maximum transfer unit (mtu) size 
is 1500 bytes (configurable on the 
box manager node only) 


Table 2-1 and Table 2-4 list the parameter defaults for the VIP/VIC and 
UNIVERSE II VMEbus adapters, respectively. 


If the existing vb: entry in /etc/sysconfigtab indicates that vb driver 
defaults have already been modified, you may need to factor the previous 
changes into your new changes. If an existing vba_vipvic: or vba_univ: 
entry in /etc/sysconfigtab indicates that adapter defaults have already 
been modified for other VMEbus device drivers in the system, you must 
factor the needs of other drivers into any changes you make for the vb driver. 


If you wish to change a vb driver attribute from its default or current 
value, you enter the attribute and its new value after the label vb: in the 
/etc/sysconfigtab file or ina sysconfigtab file fragment. 


Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain a 

private sysconfigtab file fragment for vb attributes and use 
sysconfigdb switches toadd (-a -f), delete (-d), or merge 

(-m -f) vb attribute values. The examples in Section 3.6 and 
Section 3.7 illustrate this approach. You must always reboot after 
changing vb driver attributes. 


You must also add or modify vba_vipvic: of vba_univ: adapter attribute 
values to map unique VMEbus windows for client communication and 
mailbox interrupts, as described in Section 3.4 and Section 3.5, respectively. 


The following code example shows a sample vb: entry in the 
/etc/sysconfigtab file or in a sysconfigtab file fragment, including 
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the associated VBA_Option bus configuration structure. Line breaks have 
been added tothe VBA_Option entry for clarity. 


In this example, only the vB Startup State and VB Netid parameters 

have been modified from their defaults. These modifications enable the vb 
driver to start up and participate in a vb network. After you complete your 
vb driver and VMEbus adapter modifications, you must reboot the system. 


vb: 


# 


# SSSVB 


# 


VB_Startup_ State = 1 
VB_Netid = 08-00-2b-e2-48-48 


VBA_Option = Manufact_Name - ‘Compaq’, 
Product_Name - ‘VME Backplane Network Driver’, 
Bus_Instance - 0, Driver Name - vb, Driver Instance - 0, 


Csrl - 0, Csr2 - 0, Vector - 0x1150, Bus Priority - 7, 
Type - C, Adpt_Config - N 


3.3.1 Modifying Per-Node vb Attributes 


The following vb driver attributes are configurable on a per-node basis in 
sysconfigtab; values can differ on each node: 


Module Config Name 


Specifies the driver name as an unquoted ASCII string. The default 
value is vb. 


VB_Startup_State 


Specifies the startup state of this driver. The default value is O (off). You 
must change this value to 1 (on) to start up the vb network. 


VB_Client_Addr_ Type 


Specifies address modifiers for the VMEbus address space used for the 
client node’s message queues. You must specify the numerical equivalent 
of the desired set of address modifier (AM_) flags, among the following: 
AM_A24 (0x1), AM_SUPER (0x2), and AM_DATA (0x4). 


You can map a node’s client communication queue memory to the 
VMEbus in either the A24 or A32 address space (AM_A24 set or clear), 
either in supervisory mode or user mode (AM_SUPER set or clear), and 
either in data or program space (AM_DATA set or clear). The default 
is AM_A24| AM_SUPER| AM_DATA, which equals 0x7. A32 program 
Space in user mode would be represented as 0x0 (no flags set). 


VB_Client_Vme_Window_Size 


Specifies the size (in bytes) of an area within the client communication 
window (as characterized by vB_Client Addr Type) to be used by 
the vb driver for its communication queues. The bigger the size, the 
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greater the number of message packets that will be preallocated for 
communication. 


The default size is Ox40000 (256 KB). If the maximum transfer unit 
(VB_Maxmtu) and maximum nodes (VB_Maxnodes) parameters, 
described below, are left at their default values of 1500 bytes and 10 
nodes, the 256 KB window size is enough for approximately 150 packets 
to be reserved for the queues. With a maximum of 10 nodes in the 
network, this default allows for approximately 15 packets per node to be 
devoted exclusively to communication between the local node and each of 
the other nodes. Increasing VB_Maxmtu would decrease the number of 
packets available per node. 


VB_Client_Vme_Window Offset 


Specifies the offset from the client communication window base address 
(A24 or A32, as characterized by VB Client Addr Type) at which to 
map client queues for other nodes to see. The default is Ox0, which maps 
the queues at the beginning of the base address. 


You must be able to adjust queue mappings because, if other VMEbus 
drivers in the system map memory to specific VME bus addresses, there 
may be conflicts. In the event of a conflict, you can either adjust a system 
VMEbus window base address or modify the offset value such that the 
queues start at a different VMEbus address. 


Although the default offset of OxO works well, you should 

consider changing the offset to a value equal to the A24 or A32 

window size minus the size of the client communication queues 
(VB_Client_Vme_Window_Size defaults to 256 KB, 0x40000). For 
example, in a 2 MB (0x200000) A24 window, specify an offset of 
0x1C0000. This moves the client communication queues to the top of the 
window, which reduces fragmentation within the window and minimizes 
potential conflict with the memory needs of other VME bus drivers. 


If you change the offset, make sure the value is on a page boundary 
(0x2000 bytes). 


VB_Interrupt_ Interface 


Specifies an interface for determining whether messages have been sent 
to the vb driver’s queues: interrupt (1) or polled (0). You should use the 
default value of 1 for better performance. The vb driver uses module 
switch interrupts. 


If you use the interrupt interface, you must ensure that the base 
address for the VME bus window that maps the inbound mailbox 
interrupts is unique among the nodes in the backplane, as configured 
in sysconfigtab. 


VB_Liveness Timeout 
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Specifies the interval in milliseconds between remote node liveness tests. 
By default, a node checks whether a remote node is still alive every 
10000 milliseconds (10 seconds). 


Be careful if you modify this value. An interval that is too short could 
cause nodes to lose liveness with each other too easily, and a lost node 
must be rebooted to resume communication. An interval that is too 
long (or 0, which specifies no liveness checking) could cause delays in 
determining that a remote node has gone down. The node could attempt 
to communicate with a shut-down node after the VMEbus mapping is 
no longer valid. 


VB_Mailbox_Addr_Type (UNIVERSE II only) 


For UNIVERSE I||-based Alpha VME systems only, specifies address 
modifiers for the VMEbus address space used to map the client node's 
inbound mailbox interrupts. You must specify the numerical equivalent 
of the desired set of address modifier (AM_) flags, among the following: 
AM_A24 (0x1), AM_SUPER (0x2), AM_DATA (0x4), and AM_A16 (0x8). 


On UNIVERSE II-based nodes, you can map a node’s mailbox interrupts 
to the VMEbus in A16, A24, or A32 address space. Specifying AM_A16 
set and AM_A24 clear selects A16; specifying AM_A24 set and 
AM_A16 clear selects A24; and specifying both AM_A16 and AM_A24 
clear selects A32. You also can map the mailbox interrupts either in 
supervisory mode or user mode (AM_SUPER set or clear), and either 

in data or program space (AM_DATA set or clear). The default is 
AM_A16| AM_SUPER]| AM _DATA, which equals OxE. A32 program 
space in user mode would be represented as Ox0 (no flags set). 


For UNIVERSE II-based nodes, the VMEbus address modifiers 

you specify for this attribute must match the adapter’s CSR 

window attributes. See the descriptions of the CSR_AM Space, 
CSR_AM Usr_Sprvsr, and CSR_AM Data_Prg attributes in Section 2.3. 


For VIP/VIC-based Alpha VME systems, do not specify this attribute; 
the VMEbus window that maps inbound mailbox interrupts is always 
A16 data space in supervisory mode. 


VB_Mailbox_ Offset 


Selects a mailbox for inbound interrupts by specifying an offset from the 
mailbox-interrupt window base address. 


You use module switches to create vb driver interrupts on the backplane. 
You can use any of four module switches for interrupts in each 
mai|box-interrupt window. For each module switch, you must specify a 
particular offset value for VB Mailbox Offset and Specify a particular 
vector number in the Vector field of the VBA_Option entry. 


For VIP/VIC-based Alpha VME systems, the offset and vector values are: 
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Module switch 0 Al6 offset 0x21, VBA_Option vector 0x1140 
Module switch 1 A16 offset 0x23, VBA_Option vector 0x1150 (default) 
Module switch 2 A16 offset 0x25, VBA_Option vector 0x1160 
Module switch 3 A16 offset 0x27, VBA_Option vector 0x1170 


The default is module switch 1. Remote nodes can use offset 0x23 added 
to a target node’s mailbox-interrupt window base address (see examples 
in Section 2.2.4.4 and Section 3.6) to cause an interrupt on the target 
node when the vb driver writes to the address. 


For UNIVERSE Il-based Alpha VME systems, the offset and vector 
values are: 


Module switch 0 Offset 0x348, VBA_Option vector 0x1140 
Module switch 1 Offset Ox34C, VBA_Option vector 0x1150 (default) 
Module switch 2 Offset 0x350, VBA_Option vector 0x1160 
Module switch 3 Offset 0x354, VBA_Option vector 0x1170 


The default is module switch 1. Remote nodes can use offset 0x34C 
added to a target node’s mailbox-interrupt window base address (see 
examples in Section 2.3.7.3 and Section 3.7) to cause an interrupt on the 
target node when the vb driver writes to the address. 


The mailbox-interrupt window base address must be unique among all 
nodes in the backplane. However, the offset need not be unique. 


If you change the module switch from the default of 1, this change must 
be reflected in both the VB_Mailbox_ Offset attribute and the Vector 
field of the VBA_Option entry for interrupts to work on the system. 


VB_Maxnodes 


Specifies the maximum number of nodes allowed in the vb network. 
The default value is 10. The maximum you specify cannot exceed 32. 
This value is examined by the vb box manager only, and determines the 
maximum number of nodes that may enter the vb network while the box 
manager is booted. 


All other client nodes adjust their maximum-nodes value according to 
the box manager’s value and do not have to know the box manager’s 
value ahead of time. 


VB_Netid 


Specifies the Ethernet hardware address of the node as an unquoted 
ASCII string; for example, 08-00-2b-e2-48-48. You must fill in this field 
with the correct Ethernet hardware address. The vb network address is 
derived from the unique Ethernet hardware address and is the shadow 
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Ethernet address. If this value is not filled in, the vb driver does not 
start up and an error message is displayed. 


One way to obtain the Ethernet hardware address of a running system 
isnetstat -I 1no (or tuo or other Ethernet device). You can also 
obtain the Ethernet address at the console prompt of a nonbooted system 
as follows: 


>>> show dev 

* VB Give Up 
Specifies whether the vb driver's probing of the box manager’s 
well-known address should time out after the number of minutes 
specified in VB_Probe Period or continue until the box manager comes 


up. The default is to time out (1). You can modify the value to continue 
probing indefinitely (0). 


¢ VB Probe Period 


Specifies the number of minutes to probe the box manager’s well-known 
address before timing out and exiting the driver. The default value is 1 
minute. This value is ignored if VB_Give_Up is set to0. 


* VB Census Change 


Specifies whether to display information whenever the driver maps to 
a new node or unmaps from a node. The default is not to display state 
changes (0). If the vb driver starts up with this value set to 1, you can 
track state changes beginning at startup. 


* VB Transfer Type (requires Tru64 UNIX Version 5.0A or higher) 


Specifies whether transfers over the bus use only programmed I/O (0) or 
can select between programmed I/O and direct memory access based on 
the transfer size (1). The default is 0, programmed IO only. 


If you set VB Transfer Type tol, direct memory access (DMA) 
transfers will be performed whenever the transfer size equals or exceeds 
the value of VB_DMA_ Threshold (256 by default); for smaller transfer 
sizes, programmed I/O (PIO) transfers will be performed. 


You can produce significant performance gains by allowing DMA 
transfers over the bus, particularly if you select the D64 data width with 
the VB_DMA_Dwidth parameter, described below. Furthermore, if all vb 
nodes in your network are running Tru64 UNIX 5.0A or higher, you 
potentially can realize even greater performance gains by modifying the 
per-network parameter VB_Maxmtu, which is described in Section 3.3.2. 


Before you enable vb DMA transfers on a node, you should consider the 
potential impact on your system, such as increased contention for DMA 
between the vb driver and devices in the system. 


* VB_DMA Threshold (requires Tru64 UNIX Version 5.0A or higher) 
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If DMA transfers over the bus are enabled (vB _ Transfer Type equals 
1), this parameter defines the threshold (a transfer size, in bytes) at 
which DMA transfers are used. Whenever a transfer size equals or 
exceeds VB_DMA Threshold (256 bytes by default), DMA is used for the 
transfer; otherwise PIO is used. 


VB_DMA_Dwidth (requires Tru64 UNIX Version 5.0A or higher) 


If DMA transfers over the bus are enabled (VB_Transfer Type 
equals 1), this parameter defines the data width to be used for the 
DMA transfers. The value 0 (the default) selects D16, 1 selects D32, 
and 2 selects D64. If DMA is enabled, you can realize the maximum 
performance gain by selecting the D64 data width. 


VB_ Developer Debug 
Reserved for future use 


3.3.2 Modifying Per-Network vb Attributes 


The following vb driver attributes are configurable on a per-network basis in 
sysconfigtab; values must match exactly on every node that participates 
in the vb network: 


VB_Box Mgr WK Addr 


Specifies the well-known VMEbus address of the box manager, to which 
the box manager maps 256 KB of global VMEbus data. This address 
and its associated 256 KB size must fit within the adapter’s configured 
inbound VMEbus address space. The default is OxBCOO00. Be careful 
when modifying this value, as it must match on every node in the vb 
network for communication to occur. 


Note 


The VB_Box_Mgr_WK_ Addr default of OxBC0000 differs from 
the default used in previous vb driver versions, OxA40000. The 
new default places the vb box manager well-known address near 
the top of what is assumed to be a 2 MB A24 or A32 window: 
0xC 00000 (window top) minus 0x040000 (256 KB size) equals 
OxBCOO000. This reduces fragmentation within the window and 
minimizes potential conflict with other VME bus drivers on the 
same node allocating memory in the same window. 


UNIVERSE II Restriction 


Section 3.7, UNIVERSE II Two-Node Network Example, uses 
the value OxF C0000 for VB_Box Mgr WK Addr. This suggested 
value does not fit into the UNIVERSE I! adapter’s default special 
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A24/A16 outbound window, due to the allocation of the A24/A16 
window’s top 64 KB for A16 space. UNIVERSE II vb nodes should 
either adjust the box manager well-known address down by 64 
KB (x10000) to OxF BOOO0 to allow use of the A24/A16 window, or 
instead use an outbound PCI-to-VME 256 KB (or larger) window 
to map the OxF C0000 value. Note that doing the latter can boost 
performance by allowing use of block transfers (BLTs) anda 
wider data path, at the cost of the added PCI resources used to 
map the window. 


¢ VB Box Mgr WK Addr Type 


Specifies address modifiers for the box manager’s well-known VME bus 
address. You must specify the numerical equivalent of the desired set 
of address modifier (AM_) flags, among the following: AM_A24 (0x1), 
AM_SUPER (0x2), and AM_DATA (0x4). 


You can map the box manager’s global data to the VMEbus in 

either the A24 or A32 address space (AM_A24 set or clear), either in 
supervisory mode or user mode (AM_SUPER set or clear), and either 

in data or program space (AM_DATA set or clear). The default is 
AM_A24| AM_SUPER| AM_DATA, which equals 0x7. Be careful when 
modifying this value, as it must match on every node in the vb network. 
If you modify this value, make sure the address is on a page boundary 
(0x2000 bytes). 


° VB_Maxmtu 


Specifies the maximum transmit unit (mtu) size, in bytes. Before Version 
5.0A of Tru64 UNIX, this value was not configurable. Beginning with 
Tru64 UNIX 5.0A, and provided all nodes in your vb network arerunning 
Tru64 UNIX 5.0A or higher, you can modify this value from its default 
of 1500 bytes up to a maximum of 16384 (16K) bytes. (Values less than 
1500 or greater than 16K default to 1500.) Specifying a larger mtu 
increases the size of transfer packets, resulting in fewer (but larger) 
packets on the transfer queues. 


You modify this value on the box manager node only; on client nodes, 
leave the value at its default. Client nodes obtain the mtu size from the 
box manager during node registration. 


Modifying vB_Maxmtu alone can produce significant performance gains 
in programmed I/O (PIO) transfers. However, using VB_Maxmtu in 
conjunction with the vB_Transfer_Type, VB_DMA Theshold, and 
VB_DMA_Dwidth parameters allows you to take advantage of direct 
memory access (DMA) transfers over the bus and potentially realize 
even greater performance gains. 
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Note that increasing the mtu size has a significant effect on the allocation 
of memory resources for the complete vb network. For example, if you 
specify 16K as the mtu, that increase is multiplied times VB_Maxnodes, 
the maximum number of nodes in the system. If your system design 
allows, you may be able to reduce the maximum number of nodes in the 
system (modify vB_Maxnodes), thereby increasing the memory resources 
available per node. 


3.4 Modifying vba_vipvic Adapter Attributes 


On each node in a vb network, you must modify VME bus adapter attributes 
in /etc/sysconfigtab to configure unique system VME bus windows for 
client communication and mailbox interrupts. If the node is VIP/VIC-based, 
you add or modify values for vba_vipvic kernel subsystem attributes, such 
aS A32_ Base, A32_ Size,A24 Base, A24 Size, andAlé Base. Section 2.2 
describes these attributes. 


Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain private 
sysconfigtab file fragments for vba_vipvic attributes and use 
sysconfigdb switches toadd (-a -f), delete (-d), or merge (-m 
-£) vba_vipvic attribute values. The example in Section 3.6 
illustrates this approach. 


Each system participating in the vb network must map its client 
communication queues to either A24 or A32 space in a unique manner. 
Allocated system VME bus window space must be sufficient to accommodate 
the size devoted to the communication queues. In addition, the system 

VME bus window of the box manager node must encompass the well-known 
address (default of OxBCO000). 


Although the address modifiers of the box manager well-known address 
and of the client communication queues are the same by default 
(A24/Supervisor/Data), they need not be the same. If they are not the same, 
configure the box manager node so that its system windows accommodate 
both sets of data. If they are the same, configure the box manager node 

so that the chosen system VME bus window accommodates both sets of 
data, starting at the well-known address, for a size equal to the size of the 
communication queues. 


For interrupting, the A1l6 system VME bus window base address must also 
be unique for all nodes in the backplane, but the size is always 0x100. 
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Table 3-2 lists the VMEbus address space parameters you can modify in 
/etc/sysconfigtab and their defaults. 


Table 3-2: VIP/VIC VMEbus Address Space Defaults 


Parameter Default Meaning 

A32_Base 0x08000000 A32 inbound DMA window base address 
A32_Size 0x08000000 A32 window size (128 MB) 

A24_ Base 0x00C 00000 A24 inbound DMA window base address 
A24 Size 0x00400000 A24 window size (4 MB) 

A16 Base 0x00000100 A16 interprocessor communication base 


address (size is always 0x100) 


See the VIP/VIC Two-Node Network Examplein Section 3.6 for examples 
of how to modify /etc/sysconfigtab for VIP/VIC-based nodes in a vb 
network. 


Note 


The size of the system VME bus window for a node should exceed 
what the vb driver needs. If the vb driver uses the entire system 
VMEbus window, no window space remains for other VME bus 
devices on the system to use. 


A system administrator must carefully configure all nodes on 
the backplane to have large enough system VME bus windows to 
accommodate the needs of each, but not so much that there is 
little room left for other nodes. The system administrator should 
make a roadmap of each system’s VME bus device addresses and 
sizes and fit the vb needs around the needs of the other devices, 
because the vb characteristics are user configurable. 


3.5 Modifying vba_univ Adapter Attributes 


On each node in a vb network, you must modify VMEbus adapter attributes 
in /etc/sysconfigtab to configure unique system VME bus windows for 
client communication and mailbox interrupts. If the node is UNIVERSE 
11-based, you add or modify values for vba_univ kernel subsystem 
attributes that configure VMEbus windows. Section 2.3 describes these 
attributes. 
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Note 


Do not directly edit /etc/sysconfigtab. Instead, use the 
sysconfigdb facility, as described in the sysconfigdb(8) 
reference page. It is recommended that you maintain private 
sysconfigtab file fragments for vba_univ attributes and use 
sysconfigdb switches toadd (-a -f), delete (-d), or merge 
(-m -£) vba_univ attribute values. The example in Section 3.7 
illustrates this approach. 


Each system participating in the vb network must map its client 
communication queues to either A24 or A32 space in a unique manner. 
Allocated system VME bus window space must be sufficient to accommodate 
the size devoted to the communication queues. In addition, the system 

VME bus window of the box manager node must encompass the well-known 
address (default of OxBCO000). 


Although the address modifiers of the box manager well-known address 
and of the client communication queues are the same by default 
(A24/Supervisor/Data), they need not be the same. If they are not the same, 
configure the box manager node so that its system windows accommodate 
both sets of data. If they are the same, configure the box manager node 

so that the chosen system VME bus window accommodates both sets of 
data, starting at the well-known address, for a size equal to the size of the 
communication queues. 


For interrupting, you must map the node’s VMEbus adapter CSRs, including 
mailbox-interrupt CSRs, toa VMEbus system window. On UNIVERSE 
1l-based nodes, extra work is required to also map the VME adapter 

CSRs (including mailbox-interrupt CSRs) of each vb partner node. On 
UNIVERSE Il-based nodes, VMEbus device CSRs are not constrained to 
A16/Supervisor/Data space and potentially could vary widely in address 
space and characteristics from node to node. For mapping purposes, you 
should organize the VME bus device CSRs for all nodes in the vb network into 
a carefully designed region of VMEbus space, such that each UNIVERSE 
11-based node can map them using a dedicated window with consistent 
VMEbus attributes. You then modify vba_univ adapter attributes on each 
UNIVERSE II node to map partner-node CSRs with a dedicated window. 


See the UNIVERSE II Two-Node Network Example in Section 3.7 for 
examples of how to modify /etc/sysconfigtab for UNIVERSE II-based 
nodes in a vb network. 
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Note 


The size of the system VME bus window for a node should be 
larger than what the vb driver needs. If the vb driver uses the 
entire system VME bus window, no window space remains for 
other VMEbus devices on the system to use. 


A system administrator must carefully configure all nodes on 
the backplane to have large enough system VME bus windows to 
accommodate the needs of each, but not so much that there is 
little room left for other nodes. The system administrator should 
make a roadmap of each system's VME bus device addresses and 
sizes and fit the vb needs around the needs of the other devices, 
because the vb characteristics are user configurable. 


3.6 VIP/VIC Two-Node Network Example 


The following steps show an easy way to configure two VIP/VIC nodes torun 
in a VMEbus backplane (vb) network: Node 0 and Node 1. 


For each node, most of the VIP/VIC and vb default values listed in Table 2-1 
and Table 3-1 are retained. In particular, the well-known VMEbus 
address of the box manager remains at its OxBCO000 default. You should 
examine the attribute defaults listed in Table 2-1 and Table 3-1, invoke 
sysconfigdb -1 vba _vipvicandsysconfigdb -1 vbon each nodeto 
uncover any previous changes to those defaults, and decide which attribute 
values require further modification. 


In this example, VIP/VIC and vb parameters that must be modified include 
the following: 


« TheA24 base address and size 

« TheA1é6 base address 

¢ Thestartup state 

¢ Thenode's Ethernet hardware address 


¢« Theclient queues offset from the base of the node’s A24 system VME bus 
window 


Configure the box manager node first. Make sure that it is either the 
VMEbus system controller node or that the system controller node is already 
up. 


To configure Node 0, perform the following steps: 


1. OnNode0O, create a sysconfigtab file fragment in a private directory; 
for example, /mypath/vipvic_sysconfigtab. Insert the label 
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vba_vipvic: at the beginning of the file. In the next few steps, you 
will construct an indented list, immediately following the label, of the 
vba_vipvic attributes you wish to modify and their values. 


This example assumes /etc/sysconfigtab contains no previous 
vba_vipvic entry. If such an entry exists, you can either remove 
the old entry (sysconfigdb -d) before adding the new, or merge 
the new attributes in with the old (sysconfigdb -m -f). You may 
need to factor the earlier vba_vipvic attribute values into your new 
modifications. 


Change the A24 base address (vba_vipvic parameter A24_ Base) 
from the default of OxCO0000 to something that encompasses the box 
manager data well-known address of OxBCO000. For example, set the 
A24 base address to OxA00000, and change the A24 size (parameter 
A24 Size) to2 MB (value 0x200000), which brings the window to just 
below the default window address of OxCOQ0000. The box manager node 
now has an A24 window of OxA00000 to OxBF FF FF. 


Change the A16 base address (parameter A16_ Base) tosomething other 
than the default of 0x100; for example, 0x000. 


The /mypath/vipvic_sysconfigtab file fragment now contains the 
following text: 
vba_vipvic: 

A24 Base = 0x00A00000 

A24 Size = 0x200000 

Al6_ Base = 0x00000000 
Close the file, then add its contents to /etc/sysconfigtab by issuing 
the following commana: 


sysconfigdb -a -f /mypath/vipvic_sysconfigtab vba_vipvic 


Create a sysconfigtab file fragment for vb attributes; for example, 
/mypath/vb_sysconfigtab. (If you want to use the default vb: entry 
provided by /etc/sysconfigtab as a starting point, you can copy the 
existing entry into the file fragment using the command sysconfigdb 
-l vb > /mypath/vb_sysconfigtab.) 


In the next few steps, you will construct an indented list, immediately 
following the label vb:, of the vb attributes you wish to modify and 
their values. 


Change the VB startup state (vb parameter vB Startup State) from 
O (off) to 1 (on). 


Specify the VB node’s Ethernet hardware address (vb parameter 
VB_Netid). For example, if the node’s Ethernet address is 
08-00-26-E 2-48-47, you would specify that address as an unquoted 
ASCII string. 
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8. Modify the client communication queues offset, VB_Client_Vme_Win- 
dow Offset, to map client queues at the top of the A24 window, 
as previously configured with the vba_vipvic attributes A24 Base 
and A24 Size. Mapping at the top of a window reduces window 
fragmentation and minimizes potential conflicts with the memory needs 
of other VMEbus drivers. Specify the value 0x1C0000, which equals 
the A24 window size (0x200000) minus the 256 KB needed for client 
queues (0x040000). 


9. The /mypath/vb_sysconfigtab file fragment now contains the 
following text: 


vb: 
VB_ Startup State = 1 
VB_Netid = 08-00-26-e2-48-47 
VB_Client_Vme_Window Offset = 0x1C0000 


Close the file, then merge its contents into /etc/sysconfigtab by 
issuing the following sysconfigdb command: 


sysconfigdb -m -f /mypath/vb_sysconfigtab vb 


10. Reboot the vb box manager node. During the boot, the vb driver 
becomes available and prints vB: messages on the console, including 
the following message: 


VB: This is the box manager node 


When you configure Node 1, do not modify any VMEbus A24 or A16 window 
attributes in /etc/sysconfigtab, except for the A24 client communication 
queues offset. For A24 Base,A24 Size,andA1é6 Base, use the defaults, 
which do not overlap with the values reconfigured for the box manager node. 
This will produce the following setup for Node 0 and Node 1: 


A24 Base Client Queues A24 End A16 Base 
A24 Address 
Node 0: OxA00000 OxB C0000 OxBFFFFF (2 MB) 0x000 
Node 1: OxC 00000 OxF C0000 OxFFFFFF (4 MB) 0x100 


To configure Node 1, perform the following steps: 


1. Createa vb sysconfigtab file fragment corresponding to Node 
O's for Node 1, changing the VB startup state (vb parameter 
VB_ Startup State) from 0 (off) to 1 (on). 


2. Specify the VB node's Ethernet hardware address (vb parameter 
VB_Netid). For example, if the node’s Ethernet address is 
08-00-26-E 2-24-50, you would specify that address as an unquoted 
ASCII string. 


3. Modify the client communication queues offset, VB_Client_Vme_Win- 
dow Offset, to map client queues at the top of the A24 window, based 
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on Node 1's A24 window size. Specify the value 0x3C0000, which equals 
the default A24 window size (0x400000) minus the 256 KB needed for 
client queues (0x040000). 


4. The/mypath/vb_sysconfigtab file fragment for Node 1 now contains 
the following text: 


vb: 
VB_Startup_State = 1 
VB_Netid = 08-00-26-e2-24-50 
VB_Client_Vme_ Window Offset = 0x3C0000 


Close the file, then merge its contents into /etc/sysconfigtab by 
issuing the following sysconfigdb command: 


sysconfigdb -m -f /mypath/vb_sysconfigtab vb 


5. Reboot Nodel. You should see vB: messages printed on the console, 
including the following message: 
VB: Box mgr address space is not configured for this system, 


thus this node is not the box manager node (OK). Be sure 
that there is a box manager in the network. 


Note 


Because Node 1 is using the system defaults for the VMEbus A24 
window, you must make sure that if you bring up an additional 
node (Node 2), you modify the addresses such that the defaults 
are not used. Even if Node 2 does not turn on the backplane 
driver, its inbound window overlaps with Node 1. Accesses to the 
window could cause a system crash or could cause error messages 
to be printed to the screen of Node 2, because Node 2 is receiving 
inbound VMEbus accesses from other nodes on addresses to 
which it has not mapped inbound. 


In summary, you should always reconfigure the VME bus addresses to be 
unique, no matter how you plan to use the VMEbus. 


3.7 UNIVERSE II Two-Node Network Example 


The following steps show an easy way to configure two UNIVERSE I! nodes 
to run in a VMEbus backplane (vb) network: Node 0, which is the box 
manager and the system controller, and Node 1. 


For each node, most of the UNIVERSE II and vb defaults listed in Table 2-4 
and Table 3-1 are retained, including most inbound and outbound window 
characteristics. You should examine the attribute defaults listed in Table 2-4 
and Table 3-1, invoke sysconfigdb -1 vba_univandsysconfigdb -1 
vb on each node to uncover any previous changes to those defaults, and 
decide which attribute values require further modification. 


Configuring a VMEbus Backplane (vb) Network 3-25 


In this example, UNIVERSE II and vb parameters that must be modified 
include the following: 


Inbound and outbound window base addresses 
Mailbox-interrupt window attributes 

The startup state 

The node’s Ethernet hardware address 


The client queues offset from the client communication window base 
address 


The box manager node's well-known VMEbus address 


Configure the box manager node first. This example assumes that the box 
manager node is the VMEbus system controller node. 


To configure Node 0, perform the following steps: 


1. 


On Node 0, create a sysconfigtab file fragment in a private 
directory; for example, /mypath/univ_sysconfigtab. Insert the 
label vba_univ: at the beginning of the file. In the next few steps, you 
will construct an indented list, immediately following the label, of the 
vba_univ attributes you wish to modify and their values. 


This example assumes /etc/sysconfigtab contains no previous 
vba_univ entry. If such an entry exists, you can either remove the 
old entry (sysconfigdb -d) before adding the new, or merge the 
new attributes in with the old (sysconfigdb -m -f). You may 
need to factor the earlier vba_univ attribute values into your new 
modifications. 


Verify that inbound VME-to-PCI (VMEbus slave) windows 0 and 1 
are configured at their default VMEbus base addresses, OxOOCO0000 
and 0x08000000. Node 1’s corresponding windows will be relocated to 
different VMEbus addresses (Ox00800000 and 0x10000000). For both 
Node 0 and Node 1, all other attributes of these windows are left at 
their defaults. 


In step 12, you will modify the box manager’s well-known VMEbus 
address to map box manager data at the top of VME-to-PCI window 0. 


Relocate outbound PCI-to-VME (PCI slave) windows 0 through 3 

to VMEbus base address 0x10000000, | eaving all other window 
attributes at their defaults. You do this by entering the value 
0x10000000 for the vba_univ parameters VME _WndO VME Address, 
VME_Wndl_VME_ Address, VME_Wnd2_ VME Address, and 
VME_Wnd3_VME Address. 


Configure the outbound PCI-to-VME windows 4 and 5 to encompass all 
of A24 address space for user-data and supervisory-data accesses to 
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other nodes in the system. Because the windows are set up by default 
for user data and supervisory data, respectively, you only need to specify 
a new base address, 0x00000000, and a new size, 16 MB, for each. Set 
VME_Wnd4_VME_ Address and VME_Wnd5 VME Address tothe value 
0x00000000, and set VME_Wnd4 Size and VME_Wnd5 Size tothe value 
0x01000000. In addition to providing a complete view of A24 address 
space for supervisory-data and user-data access, this mapping allows 
use of MBLTs and data widths up to Dé4. 


Configure the outbound PCI-to-VME window 6 as a mailbox-interrupt 
window. To do this, you design a region of VMEbus space that 
encompasses the UNIVERSE I| adapter CSRs (4KB per node), including 
mailbox-interrupt CSRs, for both Node 0 and the partner node, Node 1. 


In this case, the base address of the mailbox-interrupt window will be 
OxF FFF 0000, its size will be 64 KB, and Node 0 and Node 1 will map 
their adapter CSRs at OxFFFFOO00 and OxF FFF 1000, respectively. 

(If location monitors were in use, you could place adapter CSRs at 

OxF FF F 0000 and OxF FFF 2000, and location monitors at OxF FF F 1000.) 


Set VME_Wnd6é_Ena tothe value 1, set VME_Wnd6é_VME_ Address 
to the value OxF FF FO000, and set the window size (parameter 
VME_Wnd6_Size) to 64 KB (value 0x00010000). 


Additionally, you must modify the mailbox-interrupt window's 
attributes to be compatible with the address modifier attributes of the 
node’s CSR window, which will be mapped in the next step. Set the 
VME _Wnd6é AM Space parameter to specify A32 space (value 2) and set 
the VME _Wnd6é AM Usr_ Sprvsr parameter to specify supervisory mode 
(value 2). Data access remains selected by default. 


Configure the node’s CSR window in accordance with the design of the 
mailbox-interrupt window configured in the previous step. For node 0, 
retain all CSR window defaults, including the VMEbus base address 
of OxF FF FOO00, A32 space, supervisory mode, and both program and 
data access. 


The /mypath/univ_sysconfigtab file fragment now contains the 
following text: 


vba_univ: 

PCI_Wnd0O_VME Address 
PCI_Wnd1l_VME Address 
VME_Wnd0_VME_ Address 
VME_Wnd1_VME_ Address 
VME_Wnd2_VME_ Address 
VME_Wnd3_VME Address = 0x10000000 
VME_Wnd4 VME Address = 0x00000000 
VME_Wnd4_ Size = 0x01000000 

VME_Wnd5_VME Address = 0x00000000 


VME_Wnd5 Size = 0x01000000 
VME_Wnd6é_Ena = 1 
VME _Wnd6_VME Address = 0xFFFF0000 


VME_Wndé_ Size = 0x00010000 


0x00C00000 
0x08000000 
0x10000000 
0x10000000 
0x10000000 
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10. 


11. 


12. 


13. 


14. 


VME_Wnd6_AM Space = 2 

VME_Wnd6é_AM Usr_ Sprvsr = 2 
Close the file, then add its contents to /etc/sysconfigtab by issuing 
the following commana: 


sysconfigdb -a -f /mypath/univ_sysconfigtab vba_univ 


Create a sysconfigtab file fragment for vb attributes; for example, 
/mypath/vb_sysconfigtab. (If you want to use the default vb: entry 
provided by /etc/sysconfigtab as a starting point, you can copy the 
existing entry into the file fragment using the command sysconfigdb 
-l vb > /mypath/vb_sysconfigtab.) 


In the next few steps, you will construct an indented list, immediately 
following the label vb:, of the vb attributes you wish to modify and 
their values. 


Change the VB startup state (vb parameter VB Startup State) from 
O (off) to 1 (on). 


Specify the VB node’s Ethernet hardware address (vb parameter 
VB_Netid). For example, if the node’s Ethernet address is 
08-00-26-E 2-48-47, you would specify that address as an unquoted 
ASCII string. 


Modify the client communication queues offset, VB_Client_Vme_Win- 
dow Offset, to map client queues at the top of a 4 MB window. 
Mapping at the top of a window reduces window fragmentation and 
minimizes potential conflicts with the memory needs of other VMEbus 
drivers. Specify the value 0x003C0000, which equals the window size 
(0x00400000) minus the 256 KB needed for client queues (0x00040000). 


Modify the box manager well-known address, VB_ Box Mgr WK Addr, 
to map box manager data at the top of VME-to-PCI window 0. In step 2, 
VME-to-PCI window 0 was configured to encompass the box manager 
well-known address that is shared among all nodes. Specify the value 
OxO0F C0000, which equals the VME-to-PCI window 0 base address 
(Ox00C00000), plus its size (Ox00400000), minus the 256 KB needed for 
the box manager’s VMEbus global data (0x00040000). 


Mailboxes reside within the CSR window. You must modify the vb 
mailbox-interrupt address type parameter, VB_ Mailbox Addr Type, 
to match the address modifier attributes associated with the CSR 
window you configured. Specify A32 address space, supervisory mode, 
and data access (value 0x6). 


The /mypath/vb_sysconfigtab file fragment now contains the 
following text: 
vb: 


VB_ Startup State = 1 
VB_Netid = 08-00-26-e2-48-47 
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VB_Client_Vme_ Window Offset = 0x003C0000 
VB_Box Mgr WK Addr = 0x00FC0000 
VB_ Mailbox Addr Type = 0x6 


Close the file, then merge its contents into /etc/sysconfigtab by 
issuing the following sysconfigdb command: 


sysconfigdb -m -f /mypath/vb_sysconfigtab vb 


15. Reboot the vb box manager node. During the boot, the vb driver 
becomes available and prints vB: messages on the console, including 
the following message: 


VB: This is the box manager node 


When you configure Node 1, you should specify UNIVERSE II and vb 
parameter values that you have carefully selected to fit well with the values 
specified for Node 0, and try to anticipate the needs of any additional nodes 
that might be added to the vb network later. For example, the values 
specified in this example produce the following setup for Node 0 and Node 1: 


Parameter Node 0 Node 1 
VME-to-PClI (inbound) window 0 address 0x00C 00000 0x00800000 
VME-to-PCI (inbound) window 1 address O0x08000000 0x10000000 
PCI-to-VME (outbound) window 0 address 0x10000000 0x08000000 
PCI-to-VME (outbound) window 1 address 0x10000000 0x08000000 
PCI-to-VME (outbound) window 2 address 0x10000000 0x08000000 
PCI-to-VME (outbound) window 3 address 0x10000000 0x08000000 
PCI-to-VME (outbound) window 4 address 0x00000000 0x00000000 
PCI-to-VME window 4 size 0x01000000 0x01000000 
PCI-to-VME (outbound) window 5 address 0x00000000 0x00000000 
PCI-to-VME window 5 size 0x01000000 0x01000000 
PCI-to-VME (mailbox-interrupt) OxF F FF 0000 OxF F FF 0000 
window 6 address 
PCI-to-VME window 6 size 0x00010000 0x00010000 
PCI-to-VME window 6 address modifiers 2 (A32), 2 (A32), 

2 (supervisory), 2 (Supervisory), 

1 (data) 1 (data) 
CSR window address OxF F FF 0000 OxF F FF 1000 
Box manager well-known address Ox00F C0000 Ox00F C0000 
Client queues offset (assumes a 4MB window) 0x003C0000 0x003C0000 
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To configure Node 1, perform the following steps: 


1. OnNodel, createa sysconfigtab file fragment corresponding to Node 
0’s in a private directory; for example, /mypath/univ_sysconfigtab. 
Insert the label vba_univ: at the beginning of the file. In the next few 
steps, you will construct an indented list, immediately following the 
label, of the vba_univ attributes you wish to modify and their values. 


2. Relocate inbound VME-to-PCI (VMEbus slave) windows 0 and 1 to 
VMEbus locations that differ from those used by Node 0’s corresponding 
windows, leaving all other window attributes at their defaults. 

Node 0 used the default VME bus base addresses 0x00C 00000 and 
0x08000000 for its VME-to-PCI windows 0 and 1. For Node 1, enter 
the values 0x00800000 and 0x10000000 for the vba_univ parameters 
PCI_Wnd0_ VME Address and PCI_Wnd1l_VME Address. 


3. Relocate outbound PClI-to-VME (PCI slave) windows 0 through 3 
to VMEbus base address 0x08000000, I eaving all other window 
attributes at their defaults. Enter the value 0x08000000 for the 
parameters VME Wnd0O VME Address, VME _Wndl_VME Address, 
VME_Wnd2_VME_Address, and VME_Wnd3_VME Address. 


4. As with Node 0, configure Node 1’s outbound PCI-to-VME windows 
4 and 5 to encompass all of A24 address space for user-data and 
supervisory-data accesses to other nodes in the system. Because the 
windows are set up by default for user data and supervisory data, 
respectively, you only need to specify a new base address, 0x00000000, 
and a new size, 16 MB, for each. Set VME_Wnd4_ VME Address 
and VME_Wnd5_VME_ Address to the value 0x00000000, and set 
VME_Wnd4_ Size and VME _Wnd5_ Size tothe value 0x01000000. 

In addition to providing a complete view of A24 address space for 
supervisory-data and user-data access, this mapping allows use of 
MBLTs and data widths up to Dé4. 


5. Configure the outbound PCI-to-VME window 6 as a mailbox-interrupt 
window, adhering to the design established during Node 0 configuration. 
As with Node 0, the base address of the mailbox-interrupt window will 
be OxF FFF 0000 and its size 64 KB. Node O and Node 1 will map their 
adapter CSRs at OxF FFF 0000 and OxF FFF 1000, respectively. 


Set VME_Wnd6é_Ena tothe value 1, set VME_Wnd6é_VME_ Address 

to the value OxF FF FO000, and set the window size (parameter 
VME_Wnd6_ Size) to 64 KB (value 0x00010000). As with Node 

0, you must modify the mailbox-interrupt window's attributes to 

be compatible with the address modifier attributes of the node's 

CSR window, which will be mapped in the next step. Set the 

VME _Wnd6é AM Space parameter to specify A32 space (value 2) and set 
the VME _Wnd6é AM Usr_ Sprvsr parameter to specify supervisory mode 
(value 2). Data access remains selected by default. 
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10. 


11. 


Configure the node’s CSR window in accordance with the design of 
the mailbox-interrupt window configured in the previous step. In 
this case, only the VMEbus base address needs modification; set 
CSR_VME_Address tothe value OxFFFF1000. Retain defaults for all 
other CSR window attributes, including A32 space, supervisory mode, 
and both program and data access. 


The /mypath/univ_sysconfigtab file fragment now contains the 
following text: 


vba_univ: 

PCI_Wnd0O_VME Address 
PCI_Wnd1_VME Address 
VME_Wnd0_VME_ Address 
VME_Wnd1_VME_ Address 
VME_Wnd2_VME_ Address 
VME_Wnd3_VME Address = 0x08000000 
VME_Wnd4_ VME Address = 0x00000000 
VME_Wnd4 Size = 0x01000000 
VME_Wnd5 VME Address = 0x00000000 
VME_Wnd5_ Size = 0x01000000 
VME_Wnd6é_Ena = 1 

VME_Wnd6é_VME Address = 0OxFFFF0000 


VME_Wndé_ Size = 0x00010000 
VME_Wnd6_AM Space = 2 
VME_Wnd6é_AM Usr_ Sprvsr = 2 
CSR_VME_Address = OxFFFF1000 


0x00800000 
0x10000000 
0x08000000 
0x08000000 
0x08000000 


Close the file, then add its contents to /etc/sysconfigtab by issuing 
the following command: 


sysconfigdb -a -f /mypath/univ_sysconfigtab vba_univ 


Create a sysconfigtab file fragment corresponding to Node 0's for 
vb attributes; for example, /mypath/vb_sysconfigtab. (If you 
want to use the default vb: entry provided by /etc/sysconfigtab 
as a starting point, you can copy the existing entry into the 

file fragment using the command sysconfigdb -1 vb > 
/mypath/vb_sysconfigtab.) 


In the next few steps, you will construct an indented list, immediately 
following the label vb:, of the vb attributes you wish to modify and 
their values. 


Change the VB startup state (vb parameter vB Startup State) from 
O (off) to 1 (on). 


Specify the VB node’s Ethernet hardware address (vb parameter 
VB_Netid). For example, if the node’s Ethernet address is 
08-00-26-E 2-24-50, you would specify that address as an unquoted 
ASCII string. 


Modify the client communication queues offset, VB_Client_Vme_Win- 
dow Offset, to map client queues at the top of a 4MB window. 
Mapping at the top of a window reduces window fragmentation and 
minimizes potential conflicts with the memory needs of other VMEbus 
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drivers. Specify the value 0x003C0000, which equals the window size 
(0x00400000) minus the 256 KB needed for client queues (0x00040000). 


12. Modify the box manager well-known address, VB_Box_ Mgr _WK_Addr, 
to map box manager data at the top of Node 0’s VME-to-PCI window 0. 
Node 0's VME-to-PCI window 0 was configured to encompass the box 
manager well-known address that is shared among all nodes. Specify 
the value OxOOF C0000, which equals Node 0’s VME-to-PCI window 0 
base address (Ox00C 00000), plus its size (0x00400000), minus the 256 
KB needed for the box manager’s VMEbus global data (0x00040000). 


13. As with Node 0, you must modify the vb mailbox-interrupt address type 
parameter, VB Mailbox Addr Type, to match the address modifier 
attributes associated with the CSR window you configured. Specify A32 
address space, supervisory mode, and data access (value 0x6). 


14. The /mypath/vb_sysconfigtab file fragment now contains the 
following text: 


vb: 
VB_ Startup State = 1 
VB_Netid = 08-00-26-e2-24-50 
VB_Client_Vme Window _Offset = 0x003C0000 
VB_Box Mgr WK Addr = 0x00FC0000 
VB_ Mailbox Addr Type = 0x6 


Close the file, then merge its contents into /etc/sysconfigtab by 
issuing the following sysconfigdb command: 


sysconfigdb -m -f /mypath/vb_sysconfigtab vb 


15. Reboot Node 1. You should see vB: messages printed on the console, 
including the following message: 
VB: Box mgr address space is not configured for this system, 


thus this node is not the box manager node (OK). Be sure 
that there is a box manager in the network. 


3.8 Related ioctl Commands 


The host’s Internet address is specified at boot time with an SIOCSIFADDR 
ioctl command. The vb interface employs the address resolution protocol 
described in arp(7) to map dynamically between Internet and Ethernet 
addresses on the local network. 


Use the SIOCRPHYSADDR ioct1 command to read the physical address of 
the VME bus backplane node. The SIOCSPHYSADDR command cannot be 
used to change the physical address of the VMEbus backplane node. The 
VMEbus backplane network does not support DE Cnet. 


Use the SIOCADDMULTI and SIOCDELMULTI ioct1 commands to add 
or delete multicast addresses. The VMEbus backplane driver recognizes a 
maximum of 64 multicast addresses. 
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Use the SIOCRDCTRS and SIOCRDZCTRS ioct1 commands to read or 
"read and clear" the Ethernet driver counters. The argument to these two 
commands is a pointer toa counter structure, ctrreq, foundin <net/if.h>. 


Use the SIOCENABLBACK and SIOCDISABLBACK ioct1 commands to 
enable and disable the interface loopback mode. 


To obtain the physical address of the adapter, use the SIOCRPHYSADDR 
command as in the following program example: 


#include <stdio.h> /* Standard I/O */ 
#include <errno.h> /* Error numbers */ 
#include <sys/socket.h> /* Socket definitions */ 
#include <sys/ioctl.h> /* ioctl commands */ 
#include <net/if.h> /* Generic interface structures */ 
main () 
int.<s3e4 > 
static struct ifdevea devea; 


/* Get a socket */ 

s = socket (AF_INET,SOCK_DGRAM, 0) ; 

if (s < 0) { 
perror ("socket") ; 
exit (1); 

} 

strcpy (devea.ifr_name,"vb0") ; 

if (ioctl(s,SIOCRPHYSADDR,&devea) < 0) { 
perror (&devea.ifr_name[0]) ; 
exit (1); 

} 


printf ("Address is "); 


for (i = 0; i < 6; i++) 

printf("sX ", devea.default_pa[li] & Oxff) ; 
printf ("\\n"); 
close(s); 


3.9 Diagnostic Messages 


The following diagnostic messages contain relevant information provided by 
the VMEbus backplane driver, and are not errors: 


VB: VME Backplane Driver 

The backplane driver is not configured to run. 
Reconfigure the VB Startup State attribute to 1 

in the vb: backplane driver subsystem in sysconfigtab. 
Driver exiting.... 


The VMEbus backplane driver is not configured on this system. This is the 
initial default state of the VMEbus driver, before you configure it to run 

by setting VB Startup Statetol. 

VB: VME Backplane Driver 

Mailbox interrupts are configured to use A24 space 


AND A16 space, which is illegal. 
Defaulting to A16 SUPER DATA space for mailbox interrupts. 
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The vb driver attributes specified in /etc/sysconfigtab use an illegal 
combination of address modifiers for the VME bus window that maps mailbox 
interrupts. The driver has reverted to a default set of address modifiers: A16 
address space, supervisory mode, and data space. 


VB: VME Backplane Driver 
VB_MAXMTU is outside the allowable range 
Setting VB_MAXMTU = 1500 


The value specified for the vb driver attribute VB_Maxmtu is less than 1500 
or greater than 16K and has been reset to the default value, 1500. 

VB: VB_Maxmtu changed to match the Box manager’s MTU n 

This message is displayed during vb client registration if the vb driver 


attribute VB_Maxmtu on the cient is not equal to VB_Maxmtu on the box 
manager node. The client value is reset to match the box manager value. 


VB: This is the box manager node 


This node’s VME bus address space contains the user-configured address for 
the box manager node as specified in the sysconfigtab file. Therefore, this 
is the box manager node. One and only one node in a backplane network 
should have this message appear at startup. 


VB: network started 


This message will appear on a node that has successfully entered the 
backplane network. 


VB: shutdown 


This message will appear when a node in the VMEbus backplane network is 
shut down. This is a normal diagnostic message. 


3.10 Errors 


This section lists and describes error messages displayed during and after 
system startup. 


3.10.1 System Startup Error Messages 


The following error messages may appear at system startup: 

VB: Ethernet address contains all zeroes! DRIVER EXITING... 

The backplane driver has been configured to be turned on, but the Ethernet 
address in the file sysconfigtab has not been changed to reflect the 


Ethernet hardware address of the node. This information must be supplied 
in order for the node to be entered in the VMEbus backplane network. 


VB: Incorrect ident in box manager memory. 


Another device is mapped to the address specified as the box manager 
well-known address in the sysconfigtab file. Be sure to reconfigure the 
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box manager address such that it does not overlap another device’s CSR 


address range. 

VB: VME Backplane Driver 

Doorbell interrupts are configured to use A16 space, which 

is not the case on this system. 

Reconfigure the VB Mailbox Addr Type attribute in sysconfigtab to 


use the correct address space according to this system’s setup. 
Driver exiting.... 


Reconfigure mailbox interrupts as instructed. 


3.10.2 Post-Startup Error Messages 


The following error messages may appear after system startup: 


VB: MALLOC failure on box mgr memory 
VB: MALLOC failure on 13 queues 


These messages indicate that the vb driver was unable to allocate memory 
for internal data structures. 


VB: Error in dma_get maps. 


The vb driver was unable to obtain VMEbus slave window mapping 
information. 

VB: Error mapping box mgr memory inbound on the VME. 

VB: Error mapping 13 queues inbound on VME. 


VB: Error mapping outbound to box mgr 
VB: Error mapping outbound to node %d 


These VMEbus mapping errors are generally caused by misconfigured 
systems on the backplane network. 


vb%d: initialization error 


The vb driver was unable to initialize the network interface. 


vb%d SIOCADDMULTI fail, multicast list full 


Too many multicast requests have been made. 
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How to Order Tru64 UNIX Documentation 


To order Tru64 UNIX documentation in the United States and Canada, call 
800-344-4825. |n other countries, contact your local Compaq subsidiary. 


If you have access to Compaq’s intranet, you can place an order at the following 
Web site: 


http://asmorder.ngo.dec.com/ 


If you need help deciding which documentation best meets your needs, see the Tru64 
UNIX Documentation Overview, which describes the structure and organization of 
the Tru64 UNIX documentation and provides brief overviews of each document. 


The following table provides the order numbers for the Tru64 UNIX operating system 
documentation kits. For additional information about ordering this and related 
documentation, see the Documentation Overview or contact Compaq. 


Name Order Number 
Tru64 UNIX Documentation CD-ROM QA-6ADAA-G8 
Tru64 UNIX Documentation Kit QA-6ADAA-GZ 
End User Documentation Kit QA-6ADAB-GZ 
Startup Documentation Kit QA-6ADAC-GZ 
General User Documentation Kit QA-6ADAD-GZ 
System and Network Management Documentation Kit QA-6ADAE-GZ 
Developer’s Documentation Kit QA-6ADAF -GZ 
Reference Pages Documentation Kit QA-6ADAG-GZ 


TruCluster Server Documentation Kit QA-6BRAA-GZ 
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Compaq welcomes your comments and suggestions on this manual. Your input will help us to write 
documentation that meets your needs. Please send your suggestions using one of the following methods: 


e This postage-paid form 
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* Fax: (603) 884-0120, Attn: UBPG Publications, ZK 03-3/Y 32 


If you are not using this form, please be sure you include the name of the document, the page number, and 
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